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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.