CKTIS / Java
java.util.Map — съпоставяне на ключове със стойности
Map<K,V> свързва всеки ключ най-много с една стойност. Научете как да извличате и актуализирате данни, да изчислявате стойности и да използвате изгледите на картата, като обърнете специално внимание на null и гаранциите на имплементацията.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
Map<K, V> map = new HashMap<>();java.util.Map<K,V> е интерфейс за съпоставяне на ключове със стойности; стойностите могат да се повтарят. HashMap не гарантира ред, докато TreeMap подрежда ключовете. Поддръжката на null зависи от имплементацията. Не променяйте съхранен ключ по начин, който влияе на сравнението му.
Map.put(k, v) добавя или заменя стойност и връща предишната; Map.remove(k) изтрива запис и връща старата му стойност. Ако записът липсва, и двата метода също връщат null. Map.get(k) връща стойността или null; Map.containsKey(k) различава липсващ запис от запис със свързана стойност null. Map.getOrDefault(k, d) връща d само когато записът липсва, а не когато свързаната стойност е null. Map.size() преброява записите; Map.containsValue(v) проверява дали дадена стойност присъства.
Map.compute(k, f) подава на функцията ключа и текущата стойност или null; резултат null изтрива записа или го оставя несъществуващ. Map.computeIfAbsent(k, f) извиква функцията, ако записът липсва или стойността му е null; съхранява само резултат, различен от null. Map.merge(k, v, f) изисква v != null: при липсващ запис или стойност null съхранява v; в противен случай съчетава старата стойност с v. Резултат null изтрива записа.
Map.keySet() предоставя множество от ключове, Map.values() — колекция от стойности, а Map.entrySet() — множество от двойки Map.Entry<K,V>. Това са изгледи, свързани с картата, а не копия; премахването чрез изглед премахва записа, ако операцията се поддържа. Map.forEach(action) обхожда всяка двойка.
Операциите, които променят картата, могат да хвърлят UnsupportedOperationException. Функциите за изчисление не трябва да променят същата карта. Методите по подразбиране на Map не гарантират нито атомарност, нито синхронизация. Примерът използва TreeMap, за да осигури детерминистичен ред на изхода.
Примери
import java.util.Map;
import java.util.TreeMap;
public class Main {
public static void main(String[] args) {
Map<String, Integer> counts = new TreeMap<>();
counts.put("pear", 1);
counts.merge("pear", 2, Integer::sum);
counts.computeIfAbsent("apple", key -> 1);
counts.compute("apple", (key, value) -> value + 1);
System.out.println(counts.get("pear"));
System.out.println(counts.getOrDefault("plum", 0));
System.out.println(counts.containsKey("plum"));
System.out.println(counts.containsValue(2));
System.out.println(counts.size());
System.out.println(counts.keySet());
System.out.println(counts.values());
System.out.println(counts.entrySet());
counts.forEach((key, value) -> System.out.println(key + ":" + value));
System.out.println(counts.remove("pear"));
System.out.println(counts.size());
}
}Резултат
3 0 false true 2 [apple, pear] [2, 3] [apple=2, pear=3] apple:2 pear:3 3 1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.