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