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.