CKTIS / Java
NoSuchElementException — zahtevani element ne obstaja
NoSuchElementException je izjema iz java.util, ki označuje, da zahtevani element ne obstaja. Pojavi se na primer, ko pokličemo Iterator.next(), če iterator nima več elementov.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
import java.util.NoSuchElementException;
// message: String; cause: Throwable
new NoSuchElementException();
new NoSuchElementException(message);
new NoSuchElementException(message, cause);
new NoSuchElementException(cause);NoSuchElementException iz java.util označuje, da zahtevani element ne obstaja. Deduje od RuntimeException, zato je nenadzorovana izjema: prevajalnik ne zahteva, da jo ujamete ali navedete v throws.
Iterator.next() sproži to izjemo, ko iteracija nima več elementov. V takem primeru ne vrne null. V običajni zanki pred pridobitvijo naslednjega elementa preverite hasNext(); false pomeni, da se je iteracija končala.
Konstruktorji sprejemajo nič argumentov, sporočilo String, vzrok Throwable ali hkrati sporočilo in vzrok. Konstruktor brez argumentov nastavi sporočilo na null; sporočilo pridobite z getMessage(). Oba konstruktorja, ki sprejemata vzrok, sta na voljo od Jave 15.
Primer najprej varno izpiše edini element, nato pa namenoma pokliče next() po koncu iteracije. Ujemanje izjeme pokaže napako; ne nadomesti preverjanja hasNext() v običajni zanki. Namesto sporočila izjeme se izpiše nespremenjena oznaka, zato pričakovani izpis ni odvisen od vsebine sporočila.
Primeri
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");
}
}
}
Rezultat
A NoSuchElementException
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.