Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

NoSuchElementException — l’elemento richiesto non esiste

NoSuchElementException è un’eccezione di java.util che indica che un elemento richiesto non esiste. Si verifica, per esempio, quando si chiama Iterator.next() e l’iteratore non contiene altri elementi.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

import java.util.NoSuchElementException;

// message: String; cause: Throwable
new NoSuchElementException();
new NoSuchElementException(message);
new NoSuchElementException(message, cause);
new NoSuchElementException(cause);

NoSuchElementException di java.util indica che un elemento richiesto non esiste. Estende RuntimeException ed è quindi un’eccezione non controllata: il compilatore non richiede né di intercettarla né di dichiararla in throws.

Iterator.next() genera questa eccezione quando l’iterazione non contiene altri elementi. In questo caso non restituisce null. In un normale ciclo, controlla hasNext() prima di recuperare un altro elemento; false significa che l’iterazione è terminata.

I costruttori accettano nessun argomento, un messaggio String, una causa Throwable oppure sia un messaggio sia una causa. Il costruttore senza argomenti imposta il messaggio su null; getMessage() consente di recuperarlo. Entrambi i costruttori che accettano una causa sono disponibili da Java 15.

L’esempio stampa prima in sicurezza l’unico elemento, poi chiama deliberatamente next() dopo la fine dell’iterazione. Intercettare l’eccezione serve a mostrare l’errore; non sostituisce il controllo di hasNext() in un normale ciclo. Viene stampata un’etichetta fissa invece del messaggio dell’eccezione, così che l’output previsto non dipenda dal suo contenuto.

Esempi

import java.util.Iterator;
import java.util.List;
import java.util.NoSuchElementException;

public class Main {
    public static void main(String[] args) {
        Iterator<String> items = List.of("A").iterator();

        while (items.hasNext()) {
            System.out.println(items.next());
        }

        try {
            items.next();
        } catch (NoSuchElementException e) {
            System.out.println("NoSuchElementException");
        }
    }
}

Risultato

A
NoSuchElementException

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti