Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Map.forEach: dejanje za vsak par ključ–vrednost

`Map.forEach` neposredno prehodi vnose v preslikavi. Dejanju tipa `BiConsumer` poda dva argumenta: najprej ključ, nato pripadajočo vrednost.

Različica: Java SE 21

Sintaksa

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

Map.forEach je privzeta metoda vmesnika java.util.Map<K, V>, na voljo od Jave 8. Sprejme BiConsumer<? super K, ? super V> in za vsak vnos pokliče accept(key, value). Dejanje lahko zapišeš kot lambda izraz (key, value) -> .... Niti dejanje niti metoda ne vrne rezultata (void).

Map.forEach deluje neposredno na preslikavi. Nasprotno je Stream.forEach zaključna operacija toka, ki sprejme Consumer z enim argumentom na element. V map.entrySet().stream().forEach(...) je ta argument objekt Map.Entry, ne dva ločena argumenta.

Če ima preslikava določen vrstni red iteracije, se dejanja izvajajo po vrstnem redu iteracije skozi entrySet(), razen če implementacija določa drugače. Ne predpostavljaj, da vsaka preslikava ohranja vrstni red vstavljanja: HashMap ga ne zagotavlja.

Če dejanje sproži izjemo, se prehod ustavi, izjema pa se prenese klicatelju. Če kot argument action podaš null, metoda Map.forEach sproži izjemo NullPointerException. V dejanju se izogibaj dodajanju ali odstranjevanju vnosov: če se med prehodom zazna odstranitev, lahko pride do ConcurrentModificationException. Privzeta implementacija ne zagotavlja niti sinhronizacije niti atomarnosti.

Primeri

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

Rezultat

pear: 3
apple: 5

Lambda izraz prejme ključ tipa `String` in vrednost tipa `Integer`. `new LinkedHashMap<>()` ohranja vrstni red vstavljanja, zato se `pear` izpiše pred `apple`.

Povezane lekcije

  • Java · Lekcija 42 · Srednja · Različica: 2

Viri