Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Map.put — vloženie alebo nahradenie hodnoty

Uložte hodnotu pod kľúčom a získajte pôvodnú hodnotu. Výsledok `null` môže znamenať, že kľúč chýbal alebo že už mal priradenú hodnotu `null`.

Verzia: Java SE 21

Syntax

V put(K key, V value)
V previous = map.put(key, value);

Map.put je inštančná metóda rozhrania java.util.Map<K, V> v Java SE 21. Zápis Map.put() je skrátené označenie tej istej metódy, nie volanie bez argumentov. Volajte map.put(key, value) s kľúčom typu K a hodnotou typu V. Ak kľúč chýba, metóda pridá položku; inak nahradí jeho hodnotu. V HashMap označujú dva rôzne objekty kľúčov tú istú položku, ak sú podľa equals rovnaké a majú rovnaký hashCode.

Metóda vracia predchádzajúcu hodnotu, nie novú. Výsledok null znamená, že položka neexistovala alebo že predchádzajúca hodnota bola null, ak to mapa povoľuje. Tieto prípady rozlíšite volaním containsKey(key) pred zápisom, pokiaľ sa mapa medzi operáciami nezmení. Uloženie hodnoty null položku neodstráni.

put je voliteľná operácia. Mapa vytvorená pomocou Map.of vyhodí UnsupportedOperationException. Mapa môže odmietnuť nepovolené null výnimkou NullPointerException, nevhodný typ výnimkou ClassCastException alebo nepovolenú vlastnosť kľúča či hodnoty výnimkou IllegalArgumentException. Zápis cez upraviteľný pohľad NavigableMap.subMap zmení podkladovú mapu; kľúč mimo rozsahu vyvolá IllegalArgumentException a nevloží sa.

HashMap aj WeakHashMap povoľujú kľúč null a hodnoty null. Položka vo WeakHashMap môže tiež zmiznúť, keď správca pamäte uvoľní jej slabo dosiahnuteľný kľúč. Po vložení novej položky metódou put do LinkedHashMap mapa automaticky zavolá removeEldestEntry. Prepísaná metóda môže vrátiť true, a tým nechať odstrániť najstaršiu položku. Samotné nahradenie hodnoty toto volanie nevyvolá.

Ak má vyrovnávacia pamäť ukladať len platné výsledky, vynechajte put, keď napríklad záporný výsledok signalizuje chybu. Map<Class<?>, Object> nezaručuje, že hodnota zodpovedá typu reprezentovanému kľúčom; overte to pred uložením pomocou type.cast(value). Ak zdieľanú mapu chráni Lock, používajte rovnaký zámok pri každom prístupe: pred try zavolajte lock.lock(), zapisujte v try a v finally zavolajte lock.unlock().

Príklady

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

Výsledok

false
null
ready
true
null
done
1

Prvé `null` vrátené metódou `put` znamená, že kľúč chýbal. Rovnaký kľúč nahradí `ready` hodnotou `null` bez odstránenia položky. Druhé `null` vrátené metódou `put` je predchádzajúca hodnota a v mape je stále iba jedna položka.

Súvisiace lekcie

  • Java · Lekcia 13 · Pokročilá · Verzia: 2
  • Java · Lekcia 17 · Pokročilá · Verzia: 2
  • Java · Lekcia 18 · Pokročilá · Verzia: 2
  • Java · Lekcia 20 · Pokročilá · Verzia: 2
  • Java · Lekcia 36 · Pokročilá · Verzia: 2
  • Java · Lekcia 35 · Základná · Verzia: 2
  • Java · Lekcia 42 · Základná · Verzia: 2
  • Java · Lekcia 57 · Základná · Verzia: 2
  • Java · Lekcia 58 · Základná · Verzia: 2
  • Java · Lekcia 40 · Stredne pokročilá · Verzia: 2

Zdroje