CKTIS / Java
NoSuchElementException — požadovaný prvok neexistuje
NoSuchElementException je výnimka z java.util, ktorá signalizuje, že požadovaný prvok neexistuje. Nastane napríklad pri zavolaní Iterator.next(), keď iterátor už nemá ďalšie prvky.
Verzia: 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 z java.util signalizuje, že požadovaný prvok neexistuje. Dedí z RuntimeException, takže ide o nekontrolovanú výnimku: kompilátor nevyžaduje jej zachytenie ani deklarovanie v throws.
Iterator.next() vyhodí túto výnimku, keď iterácia už nemá ďalšie prvky. V takej situácii nevracia null. V bežnom cykle pred získaním ďalšieho prvku skontroluj hasNext(); hodnota false znamená, že iterácia sa skončila.
K dispozícii sú štyri konštruktory: bez argumentov, iba so správou typu String, iba s príčinou typu Throwable a so správou aj príčinou. Konštruktor bez argumentov nastaví správu na null; správu možno získať pomocou getMessage(). Oba konštruktory prijímajúce príčinu sú dostupné od Javy 15.
Príklad najprv bezpečne vypíše jediný prvok a potom zámerne zavolá next() po skončení iterácie. Zachytenie výnimky ukazuje chybu; nenahrádza kontrolu hasNext() v bežnom cykle. Namiesto správy výnimky sa vypíše pevný štítok, aby očakávaný výstup nezávisel od jej znenia.
Prí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ýsledok
A NoSuchElementException
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.