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