Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri