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