Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes