Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Map.forEach: akcja dla każdej pary klucz–wartość

`Map.forEach` przechodzi bezpośrednio po wpisach mapy. Przekazuje do `BiConsumer` dwa argumenty: najpierw klucz, potem przypisaną mu wartość.

Wersja: Java SE 21

Składnia

default void forEach(BiConsumer<? super K, ? super V> action)

Map.forEach to metoda domyślna interfejsu java.util.Map<K, V>, dostępna od Javy 8. Przyjmuje BiConsumer<? super K, ? super V> i dla każdego wpisu wywołuje accept(key, value). Akcję można zapisać jako lambdę (key, value) -> .... Ani akcja, ani metoda nie zwraca wyniku (void).

Map.forEach działa bezpośrednio na mapie. Z kolei Stream.forEach to operacja końcowa strumienia, która przyjmuje Consumer z jednym argumentem na element. W map.entrySet().stream().forEach(...) tym argumentem jest obiekt Map.Entry, a nie dwa osobne argumenty.

Jeśli mapa ma określoną kolejność iteracji, akcje wykonują się w kolejności iteracji po entrySet(), chyba że implementacja stanowi inaczej. Nie zakładaj, że każda mapa zachowuje kolejność wstawiania; HashMap jej nie gwarantuje.

Jeśli akcja rzuci wyjątek, iteracja się kończy, a wyjątek trafia do wywołującego. Akcja równa null powoduje NullPointerException. Unikaj dodawania lub usuwania wpisów w akcji: usunięcie wykryte podczas iteracji może spowodować ConcurrentModificationException. Implementacja domyślna nie gwarantuje synchronizacji ani atomowości.

Przykłady

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));
    }
}

Wynik

pear: 3
apple: 5

Lambda otrzymuje klucz typu `String` i wartość typu `Integer`. `new LinkedHashMap<>()` zachowuje kolejność wstawiania, więc `pear` pojawia się przed `apple`.

Powiązane lekcje

  • Java · Lekcja 42 · Średniozaawansowany · Wersja: 2

Źródła