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

CKTIS / Java

Iterable — un contrat pour parcourir des éléments

java.lang.Iterable<T> permet d’utiliser un objet dans une boucle for améliorée. Sa méthode iterator() fournit un itérateur, tandis que la méthode par défaut forEach() applique une action aux éléments successifs.

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

Syntaxe

public interface Iterable<T>
Iterator<T> iterator()
default void forEach(Consumer<? super T> action)

java.lang.Iterable<T> permet d’utiliser un objet dans une boucle for améliorée ; T indique le type des éléments. Il s’agit d’un contrat de parcours, et non d’un conteneur concret.

Iterable.iterator() renvoie un Iterator<T>. Distinguez l’objet qui fournit l’itération de l’itérateur qui en suit la progression : hasNext() vérifie si un élément est disponible et next() le récupère. Lorsqu’aucun élément n’est disponible, next() lance une NoSuchElementException.

Iterable.forEach(Consumer<? super T> action) est une méthode par défaut. Elle traite les éléments dans l’ordre d’itération, s’il est défini. Une exception de l’action interrompt le traitement et est propagée à l’appelant ; une action null provoque une NullPointerException. Ne modifiez pas la source dans l’action : le comportement n’est pas spécifié, sauf si l’implémentation définit une politique appropriée.

L’exemple implémente iterator() à l’aide de la liste ordonnée List.of("A", "B") et hérite de forEach(). Ici, chaque appel à iterator() crée un nouvel itérateur ; les deux parcours affichent donc les deux éléments.

Exemples

import java.util.Iterator;
import java.util.List;

public class Main implements Iterable<String> {
    @Override
    public Iterator<String> iterator() {
        return List.of("A", "B").iterator();
    }

    public static void main(String[] args) {
        Main letters = new Main();
        for (String letter : letters) {
            System.out.println("loop: " + letter);
        }
        letters.forEach(letter -> System.out.println("action: " + letter));
    }
}

Résultat

loop: A
loop: B
action: A
action: B

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