CKTIS / Java
Map.forEach: akcia pre každú dvojicu kľúč–hodnota
`Map.forEach` prechádza priamo položky mapy. Akcii typu `BiConsumer` odovzdáva dva argumenty: najprv kľúč a potom hodnotu, ktorá k nemu patrí.
Verzia: Java SE 21
Syntax
default void forEach(BiConsumer<? super K, ? super V> action)Map.forEach je predvolená metóda rozhrania java.util.Map<K, V>, dostupná od Javy 8. Prijíma BiConsumer<? super K, ? super V> a pre každú položku volá accept(key, value). Akciu môžeš zapísať ako lambda výraz (key, value) -> .... Akcia ani metóda nevracajú výsledok (void).
Map.forEach pracuje priamo s mapou. Naproti tomu Stream.forEach je koncová operácia prúdu, ktorá prijíma Consumer s jedným argumentom na prvok. V map.entrySet().stream().forEach(...) je týmto argumentom objekt Map.Entry, nie dva samostatné argumenty.
Ak má mapa určené poradie iterácie, akcie sa vykonajú v poradí iterácie cez entrySet(), pokiaľ implementácia neurčuje inak. Nepredpokladaj, že každá mapa zachováva poradie vkladania: HashMap ho nezaručuje.
Ak akcia vyvolá výnimku, prechod sa zastaví a výnimka sa prenesie k volajúcemu. Ak ako argument action odovzdáš null, metóda Map.forEach vyvolá výnimku NullPointerException. V akcii sa vyhýbaj pridávaniu alebo odoberaniu položiek: odobratie zistené počas prechodu môže spôsobiť ConcurrentModificationException. Predvolená implementácia nezaručuje synchronizáciu ani atomicitu.
Prí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ýsledok
pear: 3 apple: 5
Lambda výraz dostáva kľúč typu `String` a hodnotu typu `Integer`. `new LinkedHashMap<>()` zachováva poradie vkladania, takže sa `pear` vypíše pred `apple`.
Súvisiace lekcie
- Java · Lekcia 42 · Stredne pokročilá · Verzia: 2