Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

java.util.Map — mapování klíčů na hodnoty

Map<K,V> přiřazuje každému klíči nejvýše jednu hodnotu. Seznamte se s vyhledáváním, aktualizací a výpočtem hodnot i s pohledy na mapu; zvláštní pozornost věnujte práci s null a zárukám implementace.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

Map<K, V> map = new HashMap<>();

java.util.Map<K,V> je rozhraní pro mapování klíčů na hodnoty; hodnoty se mohou opakovat. HashMap nezaručuje žádné pořadí, zatímco TreeMap klíče řadí. Podpora null závisí na implementaci. Neměňte uložený klíč způsobem, který ovlivňuje jeho porovnávání.

Map.put(k, v) přidá nebo nahradí hodnotu a vrátí předchozí; Map.remove(k) odstraní položku a vrátí její starou hodnotu. Pokud položka chybí, obě metody také vrátí null. Map.get(k) vrátí hodnotu nebo null; Map.containsKey(k) rozlišuje chybějící položku od položky s přiřazenou hodnotou null. Map.getOrDefault(k, d) vrátí d pouze při chybějící položce, nikoli při přiřazené hodnotě null. Map.size() počítá položky; Map.containsValue(v) ověřuje, zda se hodnota vyskytuje.

Map.compute(k, f) předá funkci klíč a aktuální hodnotu, případně null; výsledek null položku odstraní nebo ji ponechá jako chybějící. Map.computeIfAbsent(k, f) zavolá funkci, pokud položka chybí nebo je její hodnota null; uloží pouze nenulový výsledek. Map.merge(k, v, f) vyžaduje v != null: při chybějící položce nebo hodnotě null uloží v, jinak spojí starou hodnotu s v. Výsledek null položku odstraní.

Map.keySet() zpřístupňuje množinu klíčů, Map.values() kolekci hodnot a Map.entrySet() množinu dvojic Map.Entry<K,V>. Jde o pohledy navázané na mapu, nikoli o kopie; odstranění přes pohled odstraní položku, pokud je tato operace podporována. Map.forEach(action) projde každou dvojici.

Operace měnící mapu mohou vyvolat UnsupportedOperationException. Výpočtové funkce by neměly měnit tutéž mapu. Výchozí metody Map nezaručují atomicitu ani synchronizaci. Příklad používá TreeMap, aby bylo pořadí výstupu deterministické.

Pří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ýsledek

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ýsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje