WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Iterable.forEach: eine Aktion für jedes Element

Rufe `forEach` auf einem `Iterable` auf, um für jedes Element eine Aktion auszuführen. Gibt das Objekt eine Iterationsreihenfolge vor, hält sich die Methode daran, sofern die implementierende Klasse nichts anderes festlegt.

Version: Java SE 21

Syntax

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

iterable.forEach(action);

Iterable.forEach(Consumer) ist eine seit Java 8 verfügbare Standardmethode (default) der Schnittstelle java.lang.Iterable<T>. Du rufst sie auf einem Objekt auf, über dessen Elemente du iterieren kannst, etwa auf einer Liste. Der Rückgabetyp ist void: Die Methode gibt keine neue Sammlung zurück.

Der Argumenttyp ist java.util.function.Consumer<? super T>. Damit kannst du eine Aktion übergeben, die ein Element als T oder als Obertyp von T annimmt. Ihre Methode accept nimmt ein Argument entgegen und liefert kein Ergebnis. Du kannst die Aktion als Lambda-Ausdruck name -> System.out.println(name) oder als Methodenreferenz System.out::println übergeben.

Die Standardimplementierung verhält sich wie eine erweiterte for-Schleife, die für jedes Element action.accept(element) aufruft. Ist die Iterationsreihenfolge festgelegt, hält forEach sie ein, sofern die implementierende Klasse nichts anderes festlegt. Die Iterationsreihenfolge einer List reicht vom ersten bis zum letzten Element. Verlass dich nicht auf eine bestimmte Reihenfolge, wenn das Objekt sie nicht garantiert.

Löst die Aktion eine Ausnahme aus, endet die Verarbeitung und die Ausnahme wird an den Aufrufer weitergegeben. Übergibst du null als Aktion, entsteht eine NullPointerException. Verändere die Quelle der Elemente nicht innerhalb der Aktion: Das Verhalten ist dann nicht spezifiziert, es sei denn, eine Klasse, die die Methode überschreibt, legt Regeln für gleichzeitige Änderungen fest.

Beispiele

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

Ergebnis

Ada
Linus
Grace

Die Methodenreferenz `System.out::println` gibt jeden Namen in einer eigenen Zeile aus. Die erwartete Reihenfolge ist `Ada`, `Linus`, `Grace`, entsprechend der Reihenfolge in der Liste.

Zugehörige Lektionen

  • Java · Lektion 64 · Grundlagen · Version: 2

Quellen