Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Iterable.forEach: dejanje za vsak element

Pokliči `forEach` na objektu `Iterable`, da izvedeš dejanje za vsak element. Če objekt določa vrstni red prehoda, ga metoda upošteva, razen če razred, ki implementira vmesnik, določa drugače.

Različica: Java SE 21

Sintaksa

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

iterable.forEach(action);

Iterable.forEach(Consumer) je privzeta metoda vmesnika java.lang.Iterable<T>, ki je na voljo od Jave 8. Pokličeš jo na objektu, po katerega elementih se lahko sprehodiš, na primer na seznamu. Vračilni tip je void: metoda ne vrne nove zbirke.

Argument je tipa java.util.function.Consumer<? super T>. Tako lahko podaš dejanje, ki sprejme element kot T ali kot nadtip tipa T. Njegova metoda accept sprejme en argument in ne vrne rezultata. Dejanje lahko podaš kot izraz lambda name -> System.out.println(name) ali kot referenco na metodo System.out::println.

Privzeta izvedba deluje kot razširjena zanka for, ki za vsak element pokliče action.accept(element). Če je vrstni red prehoda določen, ga forEach upošteva, razen če razred, ki implementira vmesnik, določa drugače. Vrstni red prehoda pri List poteka od prvega do zadnjega elementa. Ne zanašaj se na določen vrstni red, če ga objekt ne zagotavlja.

Če dejanje sproži izjemo, se obdelava ustavi, izjema pa se prenese do klicatelja. Če kot dejanje podaš null, se sproži NullPointerException. Znotraj dejanja ne spreminjaj vira elementov: v tem primeru vedenje metode ni določeno, razen če razred, ki metodo prepiše, določa pravila za sočasno spreminjanje.

Primeri

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

Rezultat

Ada
Linus
Grace

Referenca na metodo `System.out::println` izpiše vsako ime v svoji vrstici. Pričakovani vrstni red je `Ada`, `Linus`, `Grace`, tako kot na seznamu.

Povezane lekcije

  • Java · Lekcija 64 · Osnovna · Različica: 2

Viri