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