Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Map.put — vložení nebo nahrazení hodnoty

Uložte hodnotu pod klíčem a získejte předchozí hodnotu. Výsledek `null` může znamenat chybějící klíč nebo klíč, ke kterému už byla přiřazena hodnota `null`.

Verze: Java SE 21

Syntaxe

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

Map.put je instanční metoda rozhraní java.util.Map<K, V> v Java SE 21. Zápis Map.put() je zkrácené označení téže metody, nikoli volání bez argumentů. Volejte map.put(key, value) s klíčem typu K a hodnotou typu V. Pokud klíč chybí, metoda přidá položku; jinak nahradí jeho hodnotu. V HashMap označují dva různé objekty klíčů stejnou položku, pokud jsou podle equals shodné a mají stejný hashCode.

Metoda vrací předchozí hodnotu, nikoli novou. Výsledek null znamená, že položka neexistovala nebo že předchozí hodnota byla null, pokud to mapa dovoluje. Oba případy rozlišíte voláním containsKey(key) před zápisem, pokud se mapa mezi těmito operacemi nezmění. Uložení hodnoty null položku neodstraní.

put je volitelná operace. Mapa vytvořená pomocí Map.of vyvolá UnsupportedOperationException. Mapa může odmítnout nepovolené null výjimkou NullPointerException, nevhodný typ výjimkou ClassCastException nebo nepovolenou vlastnost klíče či hodnoty výjimkou IllegalArgumentException. Zápis přes upravitelný pohled NavigableMap.subMap změní podkladovou mapu; klíč mimo rozsah vyvolá IllegalArgumentException a nevloží se.

HashMap i WeakHashMap umožňují klíč null a hodnoty null. Položka v WeakHashMap může také zmizet, když správce paměti uvolní její slabě dosažitelný klíč. Po vložení nové položky metodou put do LinkedHashMap mapa automaticky zavolá removeEldestEntry. Přepsaná metoda může vrátit true a tím nechat odstranit nejstarší položku. Pouhé nahrazení hodnoty toto volání nevyvolá.

Pokud má mezipaměť ukládat jen platné výsledky, přeskočte put, když například záporný výsledek signalizuje chybu. Map<Class<?>, Object> nezaručuje, že hodnota odpovídá typu reprezentovanému klíčem; ověřte to před uložením pomocí type.cast(value). Pokud sdílenou mapu chrání Lock, používejte stejný zámek při každém přístupu: před try zavolejte lock.lock(), zapisujte uvnitř try a v finally zavolejte lock.unlock().

Pří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ýsledek

false
null
ready
true
null
done
1

První `null` vrácené metodou `put` znamená, že klíč chyběl. Shodný klíč nahradí `ready` hodnotou `null`, aniž položku odstraní. Druhé `null` vrácené metodou `put` je předchozí hodnota a v mapě je stále jen jedna položka.

Související lekce

  • Java · Lekce 13 · Pokročilá · Verze: 2
  • Java · Lekce 17 · Pokročilá · Verze: 2
  • Java · Lekce 18 · Pokročilá · Verze: 2
  • Java · Lekce 20 · Pokročilá · Verze: 2
  • Java · Lekce 36 · Pokročilá · Verze: 2
  • Java · Lekce 35 · Základní · Verze: 2
  • Java · Lekce 42 · Základní · Verze: 2
  • Java · Lekce 57 · Základní · Verze: 2
  • Java · Lekce 58 · Základní · Verze: 2
  • Java · Lekce 40 · Středně pokročilá · Verze: 2

Zdroje