Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

NoSuchElementException — l’élément demandé n’existe pas

NoSuchElementException est une exception de java.util qui signale qu’un élément demandé n’existe pas. Elle se produit, par exemple, lorsque Iterator.next() est appelé alors que l’itérateur ne contient plus d’éléments.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

import java.util.NoSuchElementException;

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

NoSuchElementException dans java.util signale qu’un élément demandé n’existe pas. Elle hérite de RuntimeException et constitue donc une exception non vérifiée : le compilateur n’exige ni qu’elle soit interceptée ni qu’elle soit déclarée dans throws.

Iterator.next() déclenche cette exception lorsque l’itération ne contient plus d’éléments. Dans ce cas, la méthode ne renvoie pas null. Dans une boucle ordinaire, vérifiez hasNext() avant de récupérer un autre élément ; false signifie que l’itération est terminée.

Il existe quatre constructeurs : l’un ne prend aucun argument, les autres prennent un message de type String, une cause de type Throwable ou les deux. Le constructeur sans argument définit le message à null ; getMessage() permet de le récupérer. Les deux constructeurs qui acceptent une cause sont disponibles depuis Java 15.

L’exemple affiche d’abord sans risque l’unique élément, puis appelle délibérément next() après la fin de l’itération. Intercepter l’exception illustre l’erreur ; cela ne remplace pas la vérification de hasNext() dans une boucle ordinaire. Une étiquette fixe est affichée à la place du message de l’exception, afin que la sortie attendue ne dépende pas de ce message.

Exemples

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

Résultat

A
NoSuchElementException

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources