Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje