CKTIS / Java
Map.put — einen Wert einfügen oder ersetzen
Speichere einen Wert unter einem Schlüssel und erhalte den vorherigen Wert zurück. Ein Rückgabewert von `null` kann zwei unterschiedliche Bedeutungen haben.
Version: Java SE 21
Syntax
V put(K key, V value)
V previous = map.put(key, value);Map.put ist eine Instanzmethode von java.util.Map<K, V> in Java SE 21. Map.put() ist eine Kurzbezeichnung derselben Methode, kein Aufruf ohne Argumente. Rufe map.put(key, value) mit einem Schlüssel vom Typ K und einem Wert vom Typ V auf. Fehlt der Schlüssel, wird ein Eintrag hinzugefügt; andernfalls wird sein Wert ersetzt. In einer HashMap bezeichnen unterschiedliche Schlüsselobjekte denselben Eintrag, wenn sie laut equals gleich sind und denselben hashCode haben.
Die Methode gibt den vorherigen Wert zurück, nicht den neuen. null bedeutet entweder, dass es keinen Eintrag gab, oder dass der vorherige Wert null war, sofern die Map dies zulässt. Prüfe vor dem Schreiben mit containsKey(key), welcher Fall vorliegt, vorausgesetzt, die Map ändert sich zwischen den Operationen nicht. Das Speichern von null als Wert entfernt den Eintrag nicht.
put ist optional. Eine mit Map.of erzeugte Map löst UnsupportedOperationException aus. Eine Map kann unzulässiges null mit NullPointerException, einen ungeeigneten Typ mit ClassCastException oder eine unzulässige Eigenschaft des Schlüssels oder Werts mit IllegalArgumentException ablehnen. Schreiben über eine veränderbare Ansicht von NavigableMap.subMap ändert die zugrunde liegende Map. Ein Schlüssel außerhalb des Bereichs löst IllegalArgumentException aus und wird nicht eingefügt.
HashMap und WeakHashMap erlauben einen null-Schlüssel und null-Werte. Ein Eintrag in einer WeakHashMap kann auch verschwinden, wenn der Garbage Collector seinen schwach erreichbaren Schlüssel verwirft. Fügt put einen neuen Eintrag in eine LinkedHashMap ein, ruft die Map automatisch removeEldestEntry auf. Eine überschreibende Implementierung kann true zurückgeben, um den ältesten Eintrag zu entfernen. Das bloße Ersetzen eines Werts löst diesen Aufruf nicht aus.
Soll ein Cache nur gültige Ergebnisse speichern, überspringe put beispielsweise dann, wenn ein negatives Ergebnis einen Fehler signalisiert. Map<Class<?>, Object> erzwingt nicht, dass ein Wert zu dem durch seinen Schlüssel repräsentierten Typ passt. Prüfe das vor dem Speichern mit type.cast(value). Schützt ein Lock eine gemeinsam genutzte Map, verwende dieselbe Sperre für alle Zugriffe: lock.lock() vor try, der Schreibzugriff in try und lock.unlock() in finally.
Beispiele
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());
}
}Ergebnis
false null ready true null done 1
Das erste von `put` zurückgegebene `null` bedeutet, dass der Schlüssel fehlte. Der gleiche Schlüssel ersetzt `ready` durch `null`, ohne den Eintrag zu entfernen. Das zweite von `put` zurückgegebene `null` ist der vorherige Wert; die Map enthält weiterhin nur einen Eintrag.
Zugehörige Lektionen
- Java · Lektion 13 · Fortgeschritten · Version: 2
- Java · Lektion 17 · Fortgeschritten · Version: 2
- Java · Lektion 18 · Fortgeschritten · Version: 2
- Java · Lektion 20 · Fortgeschritten · Version: 2
- Java · Lektion 36 · Fortgeschritten · Version: 2
- Java · Lektion 35 · Grundlagen · Version: 2
- Java · Lektion 42 · Grundlagen · Version: 2
- Java · Lektion 57 · Grundlagen · Version: 2
- Java · Lektion 58 · Grundlagen · Version: 2
- Java · Lektion 40 · Mittlere Stufe · Version: 2
Quellen
- 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)