WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

NoSuchElementException — das angeforderte Element ist nicht vorhanden

NoSuchElementException ist eine Ausnahme aus java.util, die anzeigt, dass ein angefordertes Element nicht vorhanden ist. Sie tritt zum Beispiel auf, wenn Iterator.next() aufgerufen wird, obwohl der Iterator keine weiteren Elemente enthält.

Version: 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 aus java.util zeigt an, dass ein angefordertes Element nicht vorhanden ist. Die Klasse erbt von RuntimeException und ist daher eine ungeprüfte Ausnahme: Der Compiler verlangt weder, dass sie abgefangen wird, noch dass sie in throws deklariert wird.

Iterator.next() löst diese Ausnahme aus, wenn die Iteration keine weiteren Elemente enthält. In diesem Fall wird nicht null zurückgegeben. Prüfe in einer gewöhnlichen Schleife hasNext(), bevor du das nächste Element abrufst; false bedeutet, dass die Iteration beendet ist.

Die Konstruktoren akzeptieren keine Argumente, eine String-Meldung, eine Throwable-Ursache oder sowohl eine Meldung als auch eine Ursache. Der parameterlose Konstruktor setzt die Meldung auf null; mit getMessage() lässt sie sich abrufen. Beide Konstruktoren, die eine Ursache akzeptieren, sind seit Java 15 verfügbar.

Das Beispiel gibt zunächst das einzige Element sicher aus und ruft dann absichtlich next() auf, nachdem die Iteration beendet ist. Das Abfangen der Ausnahme veranschaulicht den Fehler; es ersetzt nicht die Prüfung von hasNext() in einer gewöhnlichen Schleife. Statt der Ausnahmemeldung wird eine feste Bezeichnung ausgegeben, damit die erwartete Ausgabe nicht von dieser Meldung abhängt.

Beispiele

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

Ergebnis

A
NoSuchElementException

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen