Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje