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

CKTIS / Java

Map.containsKey a Map.put: přítomnost klíče a hodnota null

Zjisti, zda mapa obsahuje klíč, i když je jeho hodnota `null`. Poznej, kdy `put` přidává položku nebo nahrazuje její hodnotu a jak se to liší od podmíněného vložení.

Verze: Java SE 21

Syntaxe

java.util.Map<K, V> — instance method signatures:
boolean containsKey(Object key)
V put(K key, V value)

Map.containsKey(Object key) vrací true, pokud mapa obsahuje položku pro daný klíč, a mapu nemění. Kontrakt Map určuje shodu pomocí Objects.equals(key, k), kde k je uložený klíč. V HashMap odpovídá nový, logicky shodný klíč existující položce. IdentityHashMap místo toho záměrně porovnává reference pomocí ==.

V mapě, která povoluje hodnoty null, například HashMap, samotné get(key) == null nerozliší chybějící položku od položky s hodnotou null. K rozlišení použij containsKey. Při nevhodném typu klíče může containsKey vyvolat ClassCastException, při nepovoleném klíči null pak NullPointerException.

Map.put(K key, V value) vytvoří položku pro chybějící klíč nebo nahradí hodnotu existující položky. Vrací předchozí hodnotu, nikoli novou. Výsledek null může znamenat, že položka dříve neexistovala nebo že její předchozí hodnota byla null. put je volitelná operace: pokud ji mapa nepodporuje, volání, které by mapu změnilo, musí vyvolat UnsupportedOperationException. Pokud by volání nemělo na mapu žádný účinek, implementace může tuto výjimku vyvolat, ale nemusí. Omezení klíčů a hodnot závisí na implementaci.

Chceš-li vložit položku jen pro chybějící klíč a zachovat existující hodnotu null, použij if (!map.containsKey(key)) map.put(key, value);. Naproti tomu putIfAbsent může existující hodnotu null nahradit. Samostatná kontrola a následný zápis netvoří vůči ostatním vláknům atomickou operaci.

Příklady

import java.util.HashMap;
import java.util.Map;

public class MapContainsKeyDemo {
    public static void main(String[] args) {
        Map<String, String> map = new HashMap<>();
        String storedKey = new String("task");
        String equalKey = new String("task");
        String missingKey = "other";

        map.put(storedKey, null);

        System.out.println("Same reference: " + (storedKey == equalKey));
        System.out.println("Equal key: contains=" + map.containsKey(equalKey)
                + ", get=" + map.get(equalKey));
        System.out.println("Missing key: contains=" + map.containsKey(missingKey)
                + ", get=" + map.get(missingKey));

        if (!map.containsKey(equalKey)) {
            map.put(equalKey, "default");
        }
        System.out.println("After guarded insert: " + map.get(equalKey));

        System.out.println("Previous value: " + map.put(equalKey, "ready"));
        System.out.println("Current value: " + map.get(storedKey));
        System.out.println("Size: " + map.size());
    }
}

Výsledek

Same reference: false
Equal key: contains=true, get=null
Missing key: contains=false, get=null
After guarded insert: null
Previous value: null
Current value: ready
Size: 1

Dva objekty `String` s textem `task` jsou si rovny, ale mají odlišné reference. Pro přítomný i chybějící klíč vrátí `get` hodnotu `null`, ale jen pro přítomný klíč vrátí `containsKey` hodnotu `true`. Podmínka zabrání vložení výchozí hodnoty. Nepodmíněné `put` vrátí předchozí hodnotu `null` a uloží `ready`, aniž by zvětšilo mapu.

Související lekce

  • Java · Lekce 17 · Pokročilá · Verze: 2
  • Java · Lekce 18 · Pokročilá · Verze: 2
  • Java · Lekce 39 · Středně pokročilá · Verze: 2

Zdroje