Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Map.put — inserire o sostituire un valore

Associa un valore a una chiave e ottieni il valore precedente. Un risultato `null` può indicare che la chiave era assente o già associata a `null`.

Versione: Java SE 21

Sintassi

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

Map.put è un metodo di istanza di java.util.Map<K, V> in Java SE 21. Map.put() è una notazione abbreviata per lo stesso metodo, non una chiamata senza argomenti. Chiama map.put(key, value) con una chiave di tipo K e un valore di tipo V. Se la chiave è assente, il metodo aggiunge una voce; altrimenti ne sostituisce il valore. In una HashMap, due oggetti chiave distinti individuano la stessa voce se sono uguali secondo equals e hanno lo stesso hashCode.

Il metodo restituisce il valore precedente, non quello nuovo. Un risultato null significa che non c’era alcuna voce oppure che il valore precedente era null, se la mappa lo ammette. Controlla containsKey(key) prima di scrivere per distinguere i due casi, a condizione che la mappa non cambi tra le operazioni. Memorizzare null come valore non rimuove la voce.

put è un’operazione facoltativa. Una mappa creata con Map.of genera UnsupportedOperationException. Una mappa può rifiutare un null non ammesso con NullPointerException, un tipo inappropriato con ClassCastException o una caratteristica non ammessa della chiave o del valore con IllegalArgumentException. Scrivere tramite una vista modificabile di NavigableMap.subMap modifica la mappa sottostante; una chiave fuori intervallo provoca IllegalArgumentException e non viene inserita.

HashMap e WeakHashMap accettano una chiave null e valori null. Una voce di WeakHashMap può anche scomparire quando il garbage collector recupera la sua chiave debolmente raggiungibile. Quando put inserisce una nuova voce in una LinkedHashMap, la mappa chiama automaticamente removeEldestEntry. Una ridefinizione del metodo può restituire true per rimuovere la voce più vecchia. La sola sostituzione di un valore non attiva questa chiamata.

Se una cache deve conservare soltanto risultati validi, evita put quando, per esempio, un risultato negativo segnala un errore. Map<Class<?>, Object> non impone che il valore corrisponda al tipo rappresentato dalla chiave: verificalo con type.cast(value) prima di memorizzarlo. Se un Lock protegge una mappa condivisa, usa lo stesso lock per tutti gli accessi: chiama lock.lock() prima di try, scrivi all’interno di try e chiama lock.unlock() in finally.

Esempi

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

Risultato

false
null
ready
true
null
done
1

Il primo `null` restituito da `put` indica che la chiave era assente. La chiave uguale sostituisce `ready` con `null` senza rimuovere la voce. Il secondo `null` restituito da `put` è il valore precedente, e la mappa contiene ancora una sola voce.

Lezioni correlate

  • Java · Lezione 13 · Avanzato · Versione: 2
  • Java · Lezione 17 · Avanzato · Versione: 2
  • Java · Lezione 18 · Avanzato · Versione: 2
  • Java · Lezione 20 · Avanzato · Versione: 2
  • Java · Lezione 36 · Avanzato · Versione: 2
  • Java · Lezione 35 · Base · Versione: 2
  • Java · Lezione 42 · Base · Versione: 2
  • Java · Lezione 57 · Base · Versione: 2
  • Java · Lezione 58 · Base · Versione: 2
  • Java · Lezione 40 · Intermedio · Versione: 2

Fonti