Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti