Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

NoSuchElementException — żądany element nie istnieje

NoSuchElementException to wyjątek z java.util sygnalizujący brak żądanego elementu. Występuje na przykład po wywołaniu Iterator.next(), gdy iterator nie ma już kolejnych elementów.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

import java.util.NoSuchElementException;

// message: String; cause: Throwable
new NoSuchElementException();
new NoSuchElementException(message);
new NoSuchElementException(message, cause);
new NoSuchElementException(cause);

NoSuchElementException z pakietu java.util sygnalizuje, że żądany element nie istnieje. Dziedziczy po RuntimeException, więc jest wyjątkiem niekontrolowanym: kompilator nie wymaga jego przechwycenia ani deklaracji w throws.

Iterator.next() zgłasza ten wyjątek, gdy iteracja nie ma już elementów. Nie zwraca wtedy null. W zwykłej pętli sprawdzaj hasNext() przed pobraniem kolejnego elementu; wynik false oznacza koniec iteracji.

Dostępne są konstruktory bez argumentów, z komunikatem String, z przyczyną Throwable oraz z komunikatem i przyczyną. Konstruktor bez argumentów ustawia komunikat na null; getMessage() odczytuje komunikat. Oba konstruktory przyjmujące przyczynę są dostępne od Java 15.

Przykład najpierw bezpiecznie wypisuje jedyny element, a następnie celowo wywołuje next() po zakończeniu iteracji. Przechwycenie wyjątku służy demonstracji, nie zastępuje sprawdzania hasNext() w zwykłej pętli. Wypisywana jest stała etykieta zamiast komunikatu wyjątku, aby oczekiwany wynik nie zależał od jego treści.

Przykłady

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");
        }
    }
}

Wynik

A
NoSuchElementException

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła