Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Iterable.forEach: akcja dla każdego elementu

Wywołaj `forEach` na obiekcie `Iterable`, aby wykonać akcję dla każdego elementu. Jeśli obiekt ma określoną kolejność iteracji, metoda jej przestrzega, chyba że klasa implementująca interfejs określa inaczej.

Wersja: Java SE 21

Składnia

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

iterable.forEach(action);

Iterable.forEach(Consumer) to metoda domyślna interfejsu java.lang.Iterable<T>, dostępna od Javy 8. Wywołujesz ją na obiekcie, po którego elementach można iterować, na przykład na liście. Metoda ma typ zwracany void: nie zwraca nowej kolekcji.

Argument ma typ java.util.function.Consumer<? super T>. Oznacza to, że akcja może przyjmować element typu T lub typu nadrzędnego. Jej metoda accept przyjmuje jeden argument i nie zwraca wyniku. Akcję możesz przekazać jako lambdę name -> System.out.println(name) albo jako referencję do metody System.out::println.

Domyślna implementacja działa jak rozszerzona pętla for, która wywołuje action.accept(element) dla każdego elementu. Jeśli kolejność iteracji jest określona, forEach jej przestrzega, chyba że klasa implementująca interfejs określa inaczej. W przypadku List kolejność iteracji biegnie od pierwszego do ostatniego elementu. Nie zakładaj określonej kolejności, jeśli obiekt jej nie gwarantuje.

Jeśli akcja zgłosi wyjątek, przetwarzanie kończy się, a wyjątek trafia do kodu wywołującego. Przekazanie null jako akcji powoduje NullPointerException. Nie modyfikuj źródła elementów wewnątrz akcji: zachowanie metody jest wtedy nieokreślone, chyba że klasa nadpisująca metodę określa zasady współbieżnej modyfikacji.

Przykłady

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

Wynik

Ada
Linus
Grace

Referencja `System.out::println` wypisuje każdą nazwę w osobnym wierszu. Oczekiwana kolejność to `Ada`, `Linus`, `Grace`, zgodnie z kolejnością listy.

Powiązane lekcje

  • Java · Lekcja 64 · Podstawowy · Wersja: 2

Źródła