Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Map.containsKey a Map.put: prítomnosť kľúča a hodnota null

Zisti, či mapa obsahuje kľúč, aj keď má hodnotu `null`. Nauč sa, kedy `put` vloží položku alebo nahradí jej hodnotu a čím sa to líši od podmieneného vloženia.

Verzia: Java SE 21

Syntax

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

Map.containsKey(Object key) vráti true, ak mapa obsahuje položku pre daný kľúč, a mapu nemení. Kontrakt Map definuje zhodu pomocou Objects.equals(key, k), kde k je uložený kľúč. V HashMap nový, logicky rovnaký kľúč zodpovedá existujúcej položke. IdentityHashMap namiesto toho zámerne porovnáva referencie pomocou ==.

V mape povoľujúcej hodnoty null, ako je HashMap, samotné get(key) == null nerozlíši chýbajúcu položku od položky s hodnotou null. Na ich rozlíšenie použi containsKey. Pri nevhodnom type kľúča môže containsKey vyvolať ClassCastException, pri nepovolenom kľúči null môže vyvolať NullPointerException.

Map.put(K key, V value) vytvorí položku pre chýbajúci kľúč alebo nahradí hodnotu existujúcej položky. Vráti predchádzajúcu hodnotu, nie novú. Výsledok null môže znamenať, že položka neexistovala alebo že jej predchádzajúca hodnota bola null. put je voliteľná operácia: ak ju mapa nepodporuje, volanie, ktoré by mapu zmenilo, musí vyvolať UnsupportedOperationException. Ak by volanie nemalo na mapu žiadny účinok, implementácia môže túto výnimku vyvolať, ale nemusí. Obmedzenia pre kľúče a hodnoty závisia od implementácie.

Ak chceš vkladať iba pri chýbajúcom kľúči a zachovať existujúcu hodnotu null, použi if (!map.containsKey(key)) map.put(key, value);. Na rozdiel od toho môže putIfAbsent existujúcu hodnotu null nahradiť. Oddelená kontrola a zápis netvoria voči iným vláknam atómovú operáciu.

Prí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ýsledok

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 textom `task` sú si rovné, ale majú odlišné referencie. Pre prítomný aj chýbajúci kľúč vráti `get` hodnotu `null`, no len pre prítomný vráti `containsKey` hodnotu `true`. Podmienka zabráni vloženiu predvolenej hodnoty. Nepodmienené `put` vráti predchádzajúcu hodnotu `null` a uloží `ready` bez zväčšenia mapy.

Súvisiace lekcie

  • Java · Lekcia 17 · Pokročilá · Verzia: 2
  • Java · Lekcia 18 · Pokročilá · Verzia: 2
  • Java · Lekcia 39 · Stredne pokročilá · Verzia: 2

Zdroje