База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

NoSuchElementException — заявеният елемент не съществува

NoSuchElementException е изключение от java.util, което показва, че заявеният елемент не съществува. Например то възниква при извикване на Iterator.next(), когато в итератора няма повече елементи.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

import java.util.NoSuchElementException;

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

NoSuchElementException от java.util показва, че заявеният елемент не съществува. То наследява RuntimeException и затова е непроверявано изключение: компилаторът не изисква то да бъде прихванато или декларирано в throws.

Iterator.next() хвърля това изключение, когато в итерацията няма повече елементи. В този случай методът не връща null. В обикновен цикъл проверявайте hasNext(), преди да извлечете следващ елемент; false означава, че итерацията е приключила.

Има четири конструктора: без аргументи, със съобщение от тип String, с причина от тип Throwable и с два аргумента — съобщение и причина. Конструкторът без аргументи задава съобщението като null; getMessage() извлича съобщението. И двата конструктора, които приемат причина, са налични от Java 15.

Примерът първо безопасно отпечатва единствения елемент, а след това умишлено извиква next() след края на итерацията. Прихващането на изключението показва грешката; то не заменя проверката на hasNext() в обикновен цикъл. Вместо съобщението на изключението се отпечатва фиксиран етикет, така че очакваният изход да не зависи от текста на съобщението.

Примери

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

Резултат

A
NoSuchElementException

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници