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