Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

NoSuchElementException — el elemento solicitado no existe

NoSuchElementException es una excepción de java.util que indica que un elemento solicitado no existe. Por ejemplo, se produce al llamar a Iterator.next() cuando el iterador ya no tiene más elementos.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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 un elemento solicitado no existe. Hereda de RuntimeException, por lo que es una excepción no comprobada: el compilador no exige que se capture ni que se declare en throws.

Iterator.next() lanza esta excepción cuando la iteración ya no tiene más elementos. En esa situación no devuelve null. En un bucle normal, comprueba hasNext() antes de obtener otro elemento; false significa que la iteración ha terminado.

Hay cuatro constructores: uno sin argumentos, uno que recibe un mensaje de tipo String, uno que recibe una causa de tipo Throwable y uno que recibe un mensaje y una causa. El constructor sin argumentos establece el mensaje en null; getMessage() permite obtenerlo. Ambos constructores que aceptan una causa están disponibles desde Java 15.

El ejemplo primero imprime de forma segura el único elemento y luego llama deliberadamente a next() una vez terminada la iteración. Capturar la excepción sirve para mostrar el fallo; no sustituye la comprobación de hasNext() en un bucle normal. Se imprime una etiqueta fija en lugar del mensaje de la excepción para que la salida esperada no dependa de su contenido.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes