Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti