CKTIS / Java
Map.forEach: un’azione per ogni coppia chiave-valore
`Map.forEach` scorre direttamente le voci di una mappa. Passa due argomenti a un `BiConsumer`: prima la chiave, poi il valore associato.
Versione: Java SE 21
Sintassi
default void forEach(BiConsumer<? super K, ? super V> action)Map.forEach è un metodo predefinito dell’interfaccia java.util.Map<K, V>, disponibile da Java 8. Accetta un BiConsumer<? super K, ? super V> e chiama accept(key, value) per ogni voce. Puoi scrivere l’azione come lambda (key, value) -> .... Né l’azione né il metodo restituiscono un risultato (void).
Map.forEach opera direttamente sulla mappa. Stream.forEach è invece un’operazione terminale di uno stream che accetta un Consumer con un argomento per elemento. In map.entrySet().stream().forEach(...), quell’argomento è un oggetto Map.Entry, non due argomenti distinti.
Se la mappa ha un ordine di iterazione definito, le azioni seguono l’ordine di iterazione di entrySet(), a meno che l’implementazione non specifichi diversamente. Non dare per scontato che ogni mappa mantenga l’ordine di inserimento: HashMap non lo garantisce.
Se l’azione lancia un’eccezione, l’iterazione si interrompe e l’eccezione si propaga al chiamante. Un’azione null causa una NullPointerException. Evita di aggiungere o rimuovere voci all’interno dell’azione: una rimozione rilevata durante l’iterazione può causare una ConcurrentModificationException. L’implementazione predefinita non garantisce né la sincronizzazione né l’atomicità.
Esempi
import java.util.LinkedHashMap;
import java.util.Map;
public class Main {
public static void main(String[] args) {
Map<String, Integer> stock = new LinkedHashMap<>();
stock.put("pear", 3);
stock.put("apple", 5);
stock.forEach((key, value) -> System.out.println(key + ": " + value));
}
}
Risultato
pear: 3 apple: 5
La lambda riceve una chiave di tipo `String` e un valore di tipo `Integer`. `new LinkedHashMap<>()` mantiene l’ordine di inserimento, quindi `pear` compare prima di `apple`.
Lezioni correlate
- Java · Lezione 42 · Intermedio · Versione: 2