CKTIS / Java
Map.forEach: een actie voor elk sleutel-waardepaar
`Map.forEach` doorloopt rechtstreeks de items van een map. De methode geeft een `BiConsumer` twee argumenten: eerst de sleutel, daarna de bijbehorende waarde.
Versie: Java SE 21
Syntax
default void forEach(BiConsumer<? super K, ? super V> action)Map.forEach is een defaultmethode van de interface java.util.Map<K, V> en is beschikbaar sinds Java 8. De methode verwacht een BiConsumer<? super K, ? super V> en roept voor elk item accept(key, value) aan. Je kunt de actie schrijven als een lambda (key, value) -> .... Zowel de actie als de methode heeft geen retourwaarde (void).
Map.forEach werkt rechtstreeks op de map. Stream.forEach is daarentegen een afsluitende streamoperatie die een Consumer met één argument per element verwacht. In map.entrySet().stream().forEach(...) is dat argument één Map.Entry-object, niet twee afzonderlijke argumenten.
Als de map een vastgelegde iteratievolgorde heeft, volgen de acties de iteratievolgorde van entrySet(), tenzij de implementatie iets anders bepaalt. Ga er niet van uit dat elke map de invoegvolgorde behoudt: HashMap garandeert die niet.
Als de actie een exceptie veroorzaakt, stopt de iteratie en wordt de exceptie doorgegeven aan de aanroeper. Als je null als argument action doorgeeft, gooit Map.forEach een NullPointerException. Voeg binnen de actie geen items toe en verwijder er geen: een verwijdering die tijdens de iteratie wordt gedetecteerd, kan een ConcurrentModificationException veroorzaken. De standaardimplementatie garandeert geen synchronisatie of atomiciteit.
Voorbeelden
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));
}
}
Resultaat
pear: 3 apple: 5
De lambda krijgt een sleutel van het type `String` en een waarde van het type `Integer`. `new LinkedHashMap<>()` behoudt de invoegvolgorde, dus `pear` verschijnt vóór `apple`.
Gerelateerde lessen
- Java · Les 42 · Gemiddeld · Versie: 2