CKTIS / Java
NoSuchElementException — požadovaný prvek neexistuje
NoSuchElementException je výjimka z java.util, která označuje, že požadovaný prvek neexistuje. Nastane například při zavolání Iterator.next(), když iterátor už neobsahuje žádné další prvky.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
import java.util.NoSuchElementException;
// message: String; cause: Throwable
new NoSuchElementException();
new NoSuchElementException(message);
new NoSuchElementException(message, cause);
new NoSuchElementException(cause);NoSuchElementException z java.util označuje, že požadovaný prvek neexistuje. Dědí z RuntimeException, takže jde o nekontrolovanou výjimku: kompilátor nevyžaduje její zachycení ani deklaraci v throws.
Iterator.next() tuto výjimku vyhodí, když iterace už neobsahuje žádné další prvky. V takovém případě nevrací null. V běžném cyklu před získáním dalšího prvku ověřte hasNext(); hodnota false znamená, že iterace skončila.
K dispozici jsou čtyři konstruktory: bez argumentů, se zprávou typu String, s příčinou typu Throwable a se zprávou i příčinou. Konstruktor bez argumentů nastaví zprávu na null; zprávu lze získat pomocí getMessage(). Oba konstruktory přijímající příčinu jsou dostupné od Javy 15.
Příklad nejprve bezpečně vypíše jediný prvek a poté záměrně zavolá next() po skončení iterace. Zachycení výjimky ukazuje chybu; nenahrazuje kontrolu hasNext() v běžném cyklu. Místo zprávy výjimky se vypíše pevný popisek, aby očekávaný výstup nezávisel na jejím znění.
Příklady
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");
}
}
}
Výsledek
A NoSuchElementException
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.