Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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