CKTIS / Java
Iterable.forEach: un’azione per ogni elemento
Chiama `forEach` su un oggetto `Iterable` per eseguire un’azione per ogni elemento. Se l’oggetto specifica un ordine di iterazione, il metodo lo rispetta, salvo diversa indicazione della classe che implementa l’interfaccia.
Versione: Java SE 21
Sintassi
default void forEach(Consumer<? super T> action)
iterable.forEach(action);Iterable.forEach(Consumer) è un metodo predefinito dell’interfaccia java.lang.Iterable<T>, disponibile da Java 8. Lo chiami su un oggetto di cui puoi scorrere gli elementi, come una lista. Il tipo restituito è void: il metodo non restituisce una nuova collezione.
L’argomento è di tipo java.util.function.Consumer<? super T>. Puoi quindi passare un’azione che accetta un elemento come T o come supertipo di T. Il suo metodo accept riceve un argomento e non restituisce alcun risultato. Puoi passare l’azione come espressione lambda, name -> System.out.println(name), o come riferimento a un metodo, System.out::println.
L’implementazione predefinita si comporta come un ciclo for avanzato che chiama action.accept(element) per ogni elemento. Se l’ordine di iterazione è specificato, forEach lo rispetta, salvo diversa indicazione della classe che implementa l’interfaccia. L’ordine di iterazione di una List va dal primo all’ultimo elemento. Non dare per scontato un ordine preciso se l’oggetto non lo garantisce.
Se l’azione lancia un’eccezione, l’elaborazione si interrompe e l’eccezione si propaga al chiamante. Passare null come azione causa una NullPointerException. Non modificare la fonte degli elementi all’interno dell’azione: in quel caso il comportamento del metodo non è specificato, a meno che una classe che lo ridefinisce non stabilisca una politica di modifica concorrente.
Esempi
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);
}
}Risultato
Ada Linus Grace
Il riferimento al metodo `System.out::println` stampa ogni nome su una riga distinta. L’ordine atteso è `Ada`, `Linus`, `Grace`, come nella lista.
Lezioni correlate
- Java · Lezione 64 · Base · Versione: 2