Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje