CKTIS / Java
Map.put — vstavljanje ali zamenjava vrednosti
Pod ključ shranite vrednost in dobite prejšnjo vrednost. Rezultat `null` lahko pomeni, da ključa ni bilo ali da je bila z njim že povezana vrednost `null`.
Različica: Java SE 21
Sintaksa
V put(K key, V value)
V previous = map.put(key, value);Map.put je metoda primerka vmesnika java.util.Map<K, V> v Java SE 21. Zapis Map.put() je skrajšano poimenovanje iste metode in ne pomeni klica brez argumentov. Pokličite map.put(key, value) s ključem tipa K in vrednostjo tipa V. Če ključa ni, metoda doda vnos, sicer zamenja njegovo vrednost. V HashMap dva različna objekta ključa označujeta isti vnos, če sta po equals enaka in imata enak hashCode.
Metoda vrne prejšnjo vrednost, ne nove. Rezultat null pomeni, da vnosa ni bilo ali da je bila prejšnja vrednost null, če jo mapa dovoljuje. Primera ločite s klicem containsKey(key) pred pisanjem, če se mapa med operacijama ne spremeni. Shranjevanje vrednosti null vnosa ne odstrani.
put je neobvezna operacija. Mapa, ustvarjena z Map.of, sproži UnsupportedOperationException. Mapa lahko zavrne nedovoljeni null z NullPointerException, neustrezen tip z ClassCastException ali nedovoljeno lastnost ključa oziroma vrednosti z IllegalArgumentException. Pisanje prek spremenljivega pogleda NavigableMap.subMap spremeni osnovno mapo; ključ zunaj območja sproži IllegalArgumentException in se ne vstavi.
HashMap in WeakHashMap dovoljujeta ključ null in vrednosti null. Vnos v WeakHashMap lahko izgine tudi, ko zbiralnik smeti odstrani njegov šibko dosegljivi ključ. Ko put vstavi nov vnos v LinkedHashMap, mapa samodejno pokliče removeEldestEntry. Prepisana metoda lahko vrne true, da se najstarejši vnos odstrani. Sama zamenjava vrednosti tega klica ne sproži.
Če naj predpomnilnik hrani samo veljavne rezultate, izpustite put, kadar na primer negativni rezultat označuje napako. Map<Class<?>, Object> ne zagotavlja, da vrednost ustreza tipu, ki ga predstavlja ključ; to pred shranjevanjem preverite z type.cast(value). Če skupno mapo varuje Lock, pri vseh dostopih uporabite isti zaklep: pokličite lock.lock() pred try, pišite znotraj try in pokličite lock.unlock() v finally.
Primeri
import java.util.HashMap;
import java.util.Map;
public class Main {
public static void main(String[] args) {
Map<String, String> statuses = new HashMap<>();
String key = "job";
String equalKey = new String(key);
System.out.println(statuses.containsKey(key));
System.out.println(statuses.put(key, "ready"));
System.out.println(statuses.put(equalKey, null));
System.out.println(statuses.containsKey(key));
System.out.println(statuses.put(key, "done"));
System.out.println(statuses.get(key));
System.out.println(statuses.size());
}
}Rezultat
false null ready true null done 1
Prvi `null`, ki ga vrne `put`, pomeni, da ključa ni bilo. Enak ključ zamenja `ready` z `null`, ne da bi odstranil vnos. Drugi `null`, ki ga vrne `put`, je prejšnja vrednost, mapa pa ima še vedno samo en vnos.
Povezane lekcije
- Java · Lekcija 13 · Napredna · Različica: 2
- Java · Lekcija 17 · Napredna · Različica: 2
- Java · Lekcija 18 · Napredna · Različica: 2
- Java · Lekcija 20 · Napredna · Različica: 2
- Java · Lekcija 36 · Napredna · Različica: 2
- Java · Lekcija 35 · Osnovna · Različica: 2
- Java · Lekcija 42 · Osnovna · Različica: 2
- Java · Lekcija 57 · Osnovna · Različica: 2
- Java · Lekcija 58 · Osnovna · Različica: 2
- Java · Lekcija 40 · Srednja · Različica: 2
Viri
- Map — put (Java SE 21 & JDK 21)
- HashMap (Java SE 21 & JDK 21)
- WeakHashMap (Java SE 21 & JDK 21)
- NavigableMap — subMap (Java SE 21 & JDK 21)
- LinkedHashMap — removeEldestEntry (Java SE 21 & JDK 21)
- Class — cast (Java SE 21 & JDK 21)
- Lock (Java SE 21 & JDK 21)
- The java Command — Using Source-File Mode (JDK 21)