CKTIS / Java
Map.forEach: akce pro každou dvojici klíč–hodnota
`Map.forEach` prochází přímo položky mapy. Akci typu `BiConsumer` předává dva argumenty: nejprve klíč a potom hodnotu, která k němu patří.
Verze: Java SE 21
Syntaxe
default void forEach(BiConsumer<? super K, ? super V> action)Map.forEach je výchozí metoda rozhraní java.util.Map<K, V>, dostupná od Javy 8. Přijímá BiConsumer<? super K, ? super V> a pro každou položku volá accept(key, value). Akci lze zapsat jako lambda výraz (key, value) -> .... Akce ani metoda nevrací výsledek (void).
Map.forEach pracuje přímo s mapou. Naproti tomu Stream.forEach je koncová operace proudu, která přijímá Consumer s jedním argumentem pro každý prvek. V map.entrySet().stream().forEach(...) je tímto argumentem objekt Map.Entry, nikoli dva samostatné argumenty.
Má-li mapa stanovené pořadí iterace, akce se provádějí v pořadí průchodu přes entrySet(), pokud implementace neurčuje jinak. Nepředpokládej, že každá mapa zachovává pořadí vložení: HashMap ho nezaručuje.
Pokud akce vyvolá výjimku, průchod se zastaví a výjimka se předá volajícímu. Pokud jako argument action předáš null, metoda Map.forEach vyvolá výjimku NullPointerException. V akci položky raději nepřidávej ani neodebírej: odebrání zjištěné během průchodu může způsobit ConcurrentModificationException. Výchozí implementace nezaručuje synchronizaci ani atomicitu.
Příklady
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));
}
}
Výsledek
pear: 3 apple: 5
Lambda výraz dostává klíč typu `String` a hodnotu typu `Integer`. `new LinkedHashMap<>()` zachovává pořadí vložení, takže se `pear` vypíše před `apple`.
Související lekce
- Java · Lekce 42 · Středně pokročilá · Verze: 2