CKTIS / Java
Map.forEach: действие за всяка двойка ключ–стойност
`Map.forEach` обхожда директно записите в карта. Методът подава на `BiConsumer` два аргумента: първо ключа, а след това свързаната с него стойност.
Версия: Java SE 21
Синтаксис
default void forEach(BiConsumer<? super K, ? super V> action)Map.forEach е метод по подразбиране на интерфейса java.util.Map<K, V>, наличен от Java 8. Той приема BiConsumer<? super K, ? super V> и извиква accept(key, value) за всеки запис. Можеш да запишеш действието като ламбда израз (key, value) -> .... Нито действието, нито методът връщат резултат (void).
Map.forEach работи директно с картата. За разлика от него Stream.forEach е крайна операция върху поток, която приема Consumer с един аргумент за всеки елемент. В map.entrySet().stream().forEach(...) този аргумент е обект Map.Entry, а не два отделни аргумента.
Ако картата има определен ред на обхождане, действията следват реда на обхождане на entrySet(), освен ако реализацията не указва друго. Не приемай, че всяка карта запазва реда на добавяне: HashMap не го гарантира.
Ако действието хвърли изключение, обхождането спира и изключението се предава на извикващия код. Ако подадеш null като аргумент action, Map.forEach хвърля NullPointerException. Избягвай добавянето или премахването на записи в самото действие: ако при обхождането се установи премахване, може да възникне ConcurrentModificationException. Реализацията по подразбиране не гарантира нито синхронизация, нито атомарност.
Примери
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));
}
}
Резултат
pear: 3 apple: 5
Ламбда изразът получава ключ от тип `String` и стойност от тип `Integer`. `new LinkedHashMap<>()` запазва реда на добавяне, затова `pear` се извежда преди `apple`.
Свързани уроци
- Java · Урок 42 · Средно · Версия: 2