CKTIS / Java
NoSuchElementException — het gevraagde element bestaat niet
NoSuchElementException is een uitzondering uit java.util die aangeeft dat een gevraagd element niet bestaat. Deze uitzondering treedt bijvoorbeeld op wanneer Iterator.next() wordt aangeroepen terwijl de iterator geen elementen meer bevat.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
import java.util.NoSuchElementException;
// message: String; cause: Throwable
new NoSuchElementException();
new NoSuchElementException(message);
new NoSuchElementException(message, cause);
new NoSuchElementException(cause);NoSuchElementException uit java.util geeft aan dat een gevraagd element niet bestaat. De uitzondering erft van RuntimeException en is dus ongecontroleerd: de compiler verplicht je niet om haar af te vangen of in throws te declareren.
Iterator.next() gooit deze uitzondering wanneer de iteratie geen elementen meer bevat. In die situatie geeft de methode niet null terug. Controleer in een gewone lus hasNext() voordat je het volgende element ophaalt; false betekent dat de iteratie is afgelopen.
De constructors accepteren geen argumenten, een String-bericht, een Throwable-oorzaak of zowel een bericht als een oorzaak. De constructor zonder argumenten stelt het bericht in op null; met getMessage() kun je het bericht ophalen. Beide constructors die een oorzaak accepteren zijn beschikbaar sinds Java 15.
Het voorbeeld drukt eerst het enige element veilig af en roept daarna bewust next() aan nadat de iteratie is afgelopen. De uitzondering afvangen laat de fout zien; het vervangt niet de controle van hasNext() in een gewone lus. Er wordt een vast label afgedrukt in plaats van het uitzonderingsbericht, zodat de verwachte uitvoer niet van dat bericht afhangt.
Voorbeelden
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");
}
}
}
Resultaat
A NoSuchElementException
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.