CKTIS / Java
Iterable.forEach: akce pro každý prvek
Zavolej `forEach` na objektu `Iterable`, aby se pro každý prvek provedla akce. Pokud objekt určuje pořadí průchodu, metoda ho dodrží, pokud třída implementující rozhraní nestanoví jinak.
Verze: Java SE 21
Syntaxe
default void forEach(Consumer<? super T> action)
iterable.forEach(action);Iterable.forEach(Consumer) je výchozí metoda rozhraní java.lang.Iterable<T>, dostupná od Javy 8. Voláš ji na objektu, jehož prvky lze procházet, například na seznamu. Návratový typ je void: metoda nevrací novou kolekci.
Argument má typ java.util.function.Consumer<? super T>. Můžeš tedy předat akci, která přijímá prvek typu T nebo nadtypu T. Její metoda accept přijímá jeden argument a nevrací výsledek. Akci můžeš předat jako lambda výraz name -> System.out.println(name) nebo jako odkaz na metodu System.out::println.
Výchozí implementace funguje jako rozšířený cyklus for, který pro každý prvek volá action.accept(element). Je-li pořadí průchodu určeno, forEach ho dodrží, pokud třída implementující rozhraní nestanoví jinak. Pořadí průchodu u List je od prvního prvku k poslednímu. Nespoléhej na konkrétní pořadí, pokud ho objekt nezaručuje.
Pokud akce vyvolá výjimku, zpracování se zastaví a výjimka se předá volajícímu. Předáním null jako akce vznikne NullPointerException. V akci neměň zdroj prvků: chování metody pak není specifikováno, ledaže třída, která metodu přepisuje, stanoví pravidla pro souběžné změny.
Příklady
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);
}
}Výsledek
Ada Linus Grace
Odkaz na metodu `System.out::println` vypíše každé jméno na samostatný řádek. Očekávané pořadí je `Ada`, `Linus`, `Grace`, stejně jako v seznamu.
Související lekce
- Java · Lekce 64 · Základní · Verze: 2