CKTIS / Java
Iterable.forEach: akcia pre každý prvok
Zavolaj `forEach` na objekte `Iterable`, aby sa pre každý prvok vykonala akcia. Ak objekt určuje poradie prechádzania, metóda ho dodrží, pokiaľ trieda implementujúca rozhranie neurčí inak.
Verzia: Java SE 21
Syntax
default void forEach(Consumer<? super T> action)
iterable.forEach(action);Iterable.forEach(Consumer) je predvolená metóda rozhrania java.lang.Iterable<T>, dostupná od Javy 8. Voláš ju na objekte, ktorého prvky môžeš prechádzať, napríklad na zozname. Návratový typ je void: metóda nevracia novú kolekciu.
Argument má typ java.util.function.Consumer<? super T>. Môžeš teda odovzdať akciu, ktorá prijíma prvok typu T alebo nadtypu T. Jej metóda accept prijíma jeden argument a nevracia výsledok. Akciu môžeš odovzdať ako lambda výraz name -> System.out.println(name) alebo ako odkaz na metódu System.out::println.
Predvolená implementácia funguje ako rozšírený cyklus for, ktorý pre každý prvok volá action.accept(element). Ak je poradie prechádzania určené, forEach ho dodrží, pokiaľ trieda implementujúca rozhranie neurčí inak. Poradie prechádzania v prípade List je od prvého prvku po posledný. Nespoliehaj sa na konkrétne poradie, ak ho objekt nezaručuje.
Ak akcia vyvolá výnimku, spracovanie sa zastaví a výnimka sa prenesie do volajúceho kódu. Odovzdanie null ako akcie spôsobí NullPointerException. V akcii nemeň zdroj prvkov: správanie metódy vtedy nie je špecifikované, pokiaľ trieda, ktorá metódu prepisuje, neurčí pravidlá pre súbežné zmeny.
Prí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ýsledok
Ada Linus Grace
Odkaz na metódu `System.out::println` vypíše každé meno na samostatný riadok. Očakávané poradie je `Ada`, `Linus`, `Grace`, rovnako ako v zozname.
Súvisiace lekcie
- Java · Lekcia 64 · Základná · Verzia: 2