CKTIS / Java
Map.containsKey in Map.put: prisotnost ključa in vrednost null
Preveri, ali preslikava vsebuje ključ, tudi če je njegova vrednost `null`. Spoznaj, kdaj `put` doda vnos ali zamenja njegovo vrednost in kako se to razlikuje od pogojnega vstavljanja.
Različica: 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) vrne true, če preslikava vsebuje vnos za ključ, ne da bi preslikavo spremenila. Pogodba vmesnika Map določa ujemanje z Objects.equals(key, k), kjer je k shranjeni ključ. V HashMap se nov, logično enak ključ ujema z obstoječim vnosom. IdentityHashMap namesto tega namenoma primerja reference z ==.
V preslikavi, ki dovoljuje vrednosti null, kot je HashMap, samo get(key) == null ne loči manjkajočega vnosa od vnosa z vrednostjo null. Za razlikovanje uporabi containsKey. Pri neustreznem tipu ključa lahko containsKey sproži ClassCastException, pri nedovoljenem ključu null pa NullPointerException.
Map.put(K key, V value) ustvari vnos za manjkajoči ključ ali zamenja vrednost obstoječega vnosa. Vrne prejšnjo vrednost, ne nove. Rezultat null lahko pomeni, da vnosa prej ni bilo ali da je bila njegova prejšnja vrednost null. put je neobvezna operacija: če je preslikava ne podpira, mora klic, ki bi preslikavo spremenil, sprožiti UnsupportedOperationException. Če klic ne bi imel učinka na preslikavo, lahko implementacija sproži to izjemo, ni pa ji treba. Omejitve ključev in vrednosti so odvisne od implementacije.
Če želiš vstaviti vnos samo ob manjkajočem ključu in ohraniti obstoječo vrednost null, uporabi if (!map.containsKey(key)) map.put(key, value);. Nasprotno lahko putIfAbsent zamenja obstoječo vrednost null. Ločeno preverjanje in zapisovanje glede na druge niti ne tvorita atomske operacije.
Primeri
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
Objekta `String` z besedilom `task` sta enaka, vendar imata različni referenci. `get` za prisotni in manjkajoči ključ vrne `null`, `containsKey` pa vrne `true` samo za prisotnega. Pogoj prepreči vstavljanje privzete vrednosti. Brezpogojni `put` vrne prejšnjo vrednost `null` in shrani `ready`, ne da bi povečal velikost preslikave.
Povezane lekcije
- Java · Lekcija 17 · Napredna · Različica: 2
- Java · Lekcija 18 · Napredna · Različica: 2
- Java · Lekcija 39 · Srednja · Različica: 2