Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje