Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Map.containsKey i Map.put: prisutnost ključa i vrijednost null

Provjeri sadrži li mapa ključ i kad mu je pridružena vrijednost `null`. Saznaj kada `put` dodaje unos ili zamjenjuje njegovu vrijednost i kako se to razlikuje od uvjetnog umetanja.

Verzija: Java SE 21

Sintaksa

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

Map.containsKey(Object key) vraća true ako mapa sadrži unos za ključ, bez izmjene mape. Ugovor sučelja Map definira podudaranje pomoću Objects.equals(key, k), gdje je k pohranjeni ključ. U HashMap novi, logički jednak ključ odgovara postojećem unosu. IdentityHashMap umjesto toga namjerno uspoređuje reference operatorom ==.

U mapi koja dopušta vrijednosti null, kao što je HashMap, sam izraz get(key) == null ne razlikuje nepostojeći unos od unosa s vrijednošću null. Za tu razliku upotrijebi containsKey. containsKey može baciti ClassCastException za neprikladan tip ključa ili NullPointerException ako ključ null nije dopušten.

Map.put(K key, V value) stvara unos za nepostojeći ključ ili zamjenjuje vrijednost postojećeg unosa. Vraća prethodnu vrijednost, a ne novu. Rezultat null može značiti da unosa prije nije bilo ili da mu je prethodna vrijednost bila null. put je opcionalna operacija: ako je mapa ne podržava, poziv koji bi promijenio mapu mora baciti UnsupportedOperationException. Ako poziv ne bi imao učinka na mapu, implementacija može baciti tu iznimku, ali ne mora. Ograničenja za ključeve i vrijednosti ovise o implementaciji.

Za umetanje samo ako ključ nedostaje, uz očuvanje postojeće vrijednosti null, upotrijebi if (!map.containsKey(key)) map.put(key, value);. Za razliku od toga, putIfAbsent može zamijeniti postojeću vrijednost null. Odvojena provjera i upis zajedno nisu atomska operacija u odnosu na druge dretve.

Primjeri

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());
    }
}

Rezultat

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 objekta `String` s tekstom `task` jednaka su, ali imaju različite reference. `get` vraća `null` i za prisutan i za nepostojeći ključ, no `containsKey` vraća `true` samo za prisutan ključ. Uvjet sprječava umetanje zadane vrijednosti. Bezuvjetni `put` vraća prethodnu vrijednost `null` i pohranjuje `ready` bez povećanja veličine mape.

Povezane lekcije

  • Java · Lekcija 17 · Napredno · Verzija: 2
  • Java · Lekcija 18 · Napredno · Verzija: 2
  • Java · Lekcija 39 · Srednje · Verzija: 2

Izvori