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

CKTIS / Java

Iterable.forEach : une action pour chaque élément

Appelle `forEach` sur un objet `Iterable` pour exécuter une action pour chaque élément. Si l’objet définit un ordre de parcours, la méthode le respecte, sauf indication contraire de la classe qui implémente l’interface.

Version : Java SE 21

Syntaxe

default void forEach(Consumer<? super T> action)

iterable.forEach(action);

Iterable.forEach(Consumer) est une méthode par défaut de l’interface java.lang.Iterable<T>, disponible depuis Java 8. Tu l’appelles sur un objet dont tu peux parcourir les éléments, comme une liste. Son type de retour est void : elle ne renvoie pas de nouvelle collection.

L’argument est de type java.util.function.Consumer<? super T>. Tu peux donc fournir une action qui accepte un élément de type T ou d’un supertype de T. Sa méthode accept prend un argument et ne renvoie aucun résultat. Tu peux passer l’action sous forme de lambda, name -> System.out.println(name), ou de référence de méthode, System.out::println.

L’implémentation par défaut se comporte comme une boucle for améliorée qui appelle action.accept(element) pour chaque élément. Si un ordre de parcours est spécifié, forEach le respecte, sauf indication contraire de la classe qui implémente l’interface. L’ordre de parcours d’une List va du premier au dernier élément. Ne présume pas d’un ordre particulier si l’objet ne le garantit pas.

Si l’action lève une exception, le traitement s’arrête et l’exception se propage au code appelant. Passer null comme action provoque une NullPointerException. Ne modifie pas la source des éléments dans l’action : le comportement de la méthode n’est alors pas spécifié, sauf si une classe qui redéfinit la méthode fixe des règles de modification concurrente.

Exemples

import java.util.List;

public class Main {
    public static void main(String[] args) {
        Iterable<String> names = List.of("Ada", "Linus", "Grace");
        names.forEach(System.out::println);
    }
}

Résultat

Ada
Linus
Grace

La référence de méthode `System.out::println` affiche chaque nom sur une ligne distincte. L’ordre attendu est `Ada`, `Linus`, `Grace`, comme dans la liste.

Leçons associées

  • Java · Leçon 64 · Débutant · Version : 2

Sources