CKTIS / Java
java.util.Map — mapovanie kľúčov na hodnoty
Map<K,V> priraďuje každému kľúču najviac jednu hodnotu. Zoznámte sa s vyhľadávaním, aktualizáciou a výpočtom hodnôt aj s pohľadmi na mapu; osobitnú pozornosť venujte práci s null a zárukám implementácie.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
Map<K, V> map = new HashMap<>();java.util.Map<K,V> je rozhranie na mapovanie kľúčov na hodnoty; hodnoty sa môžu opakovať. HashMap nezaručuje žiadne poradie, zatiaľ čo TreeMap kľúče triedi. Podpora null závisí od implementácie. Nemeňte uložený kľúč spôsobom, ktorý ovplyvňuje jeho porovnávanie.
Map.put(k, v) pridá alebo nahradí hodnotu a vráti predchádzajúcu; Map.remove(k) odstráni položku a vráti jej starú hodnotu. Ak položka chýba, obe metódy tiež vrátia null. Map.get(k) vráti hodnotu alebo null; Map.containsKey(k) rozlišuje chýbajúcu položku od položky s priradenou hodnotou null. Map.getOrDefault(k, d) vráti d iba pri chýbajúcej položke, nie pri priradenej hodnote null. Map.size() počíta položky; Map.containsValue(v) overuje, či sa hodnota vyskytuje.
Map.compute(k, f) odovzdá funkcii kľúč a aktuálnu hodnotu alebo null; výsledok null položku odstráni alebo ju ponechá ako chýbajúcu. Map.computeIfAbsent(k, f) zavolá funkciu, ak položka chýba alebo je jej hodnota null; uloží iba nenulový výsledok. Map.merge(k, v, f) vyžaduje v != null: pri chýbajúcej položke alebo hodnote null uloží v, inak spojí starú hodnotu s v. Výsledok null položku odstráni.
Map.keySet() sprístupňuje množinu kľúčov, Map.values() kolekciu hodnôt a Map.entrySet() množinu dvojíc Map.Entry<K,V>. Ide o pohľady naviazané na mapu, nie o kópie; odstránenie cez pohľad odstráni položku, ak je táto operácia podporovaná. Map.forEach(action) prejde každú dvojicu.
Operácie meniace mapu môžu vyvolať UnsupportedOperationException. Výpočtové funkcie by nemali meniť tú istú mapu. Predvolené metódy Map nezaručujú atomicitu ani synchronizáciu. Príklad používa TreeMap, aby bolo poradie výstupu deterministické.
Príklady
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());
}
}Výsledok
3 0 false true 2 [apple, pear] [2, 3] [apple=2, pear=3] apple:2 pear:3 3 1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.