CKTIS / Java
NoSuchElementException — o elemento pedido não existe
NoSuchElementException é uma exceção de java.util que indica que um elemento pedido não existe. Ocorre, por exemplo, quando se chama Iterator.next() e o iterador já não tem mais elementos.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
import java.util.NoSuchElementException;
// message: String; cause: Throwable
new NoSuchElementException();
new NoSuchElementException(message);
new NoSuchElementException(message, cause);
new NoSuchElementException(cause);NoSuchElementException de java.util indica que um elemento pedido não existe. Herda de RuntimeException e é, por isso, uma exceção não verificada: o compilador não exige que seja capturada nem declarada em throws.
Iterator.next() lança esta exceção quando a iteração já não tem mais elementos. Nessa situação, não devolve null. Num ciclo normal, verifica hasNext() antes de obter outro elemento; false significa que a iteração terminou.
Os construtores aceitam nenhum argumento, uma mensagem String, uma causa Throwable ou tanto uma mensagem como uma causa. O construtor sem argumentos define a mensagem como null; getMessage() permite obtê-la. Ambos os construtores que aceitam uma causa estão disponíveis desde Java 15.
O exemplo imprime primeiro, em segurança, o único elemento e, em seguida, chama deliberadamente next() depois de a iteração terminar. Capturar a exceção demonstra a falha; não substitui a verificação de hasNext() num ciclo normal. É impressa uma etiqueta fixa em vez da mensagem da exceção, para que o resultado esperado não dependa dessa mensagem.
Exemplos
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");
}
}
}
Resultado
A NoSuchElementException
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.