CKTIS / Java
Map.put — een waarde toevoegen of vervangen
Sla een waarde op onder een sleutel en krijg de vorige waarde terug. Een resultaat van `null` kan wijzen op een ontbrekende sleutel of op een eerder opgeslagen `null`.
Versie: Java SE 21
Syntax
V put(K key, V value)
V previous = map.put(key, value);Map.put is een instantiemethode van java.util.Map<K, V> in Java SE 21. Map.put() is een verkorte aanduiding van dezelfde methode, geen aanroep zonder argumenten. Roep map.put(key, value) aan met een sleutel van type K en een waarde van type V. Ontbreekt de sleutel, dan wordt een item toegevoegd; anders wordt de bijbehorende waarde vervangen. In een HashMap verwijzen twee verschillende sleutelobjecten naar hetzelfde item als ze volgens equals gelijk zijn en dezelfde hashCode hebben.
De methode geeft de vorige waarde terug, niet de nieuwe. Een resultaat van null betekent dat er geen item was of dat de vorige waarde null was, als de map dat toestaat. Controleer containsKey(key) vóór het schrijven om die gevallen te onderscheiden, zolang de map tussendoor niet verandert. Het opslaan van null als waarde verwijdert het item niet.
put is een optionele bewerking. Een met Map.of gemaakte map werpt UnsupportedOperationException. Een map kan een niet-toegestane null afwijzen met NullPointerException, een ongeschikt type met ClassCastException of een niet-toegestane eigenschap van een sleutel of waarde met IllegalArgumentException. Schrijven via een wijzigbare weergave van NavigableMap.subMap wijzigt de onderliggende map; een sleutel buiten het bereik leidt tot IllegalArgumentException en wordt niet toegevoegd.
HashMap en WeakHashMap staan een null-sleutel en null-waarden toe. Een item in een WeakHashMap kan ook verdwijnen wanneer de garbagecollector de zwak bereikbare sleutel opruimt. Nadat put een nieuw item aan een LinkedHashMap heeft toegevoegd, roept de map automatisch removeEldestEntry aan. Een overschreven versie kan true teruggeven om het oudste item te verwijderen. Alleen een waarde vervangen leidt niet tot zo’n aanroep.
Moet een cache alleen geldige resultaten bewaren, sla put dan over wanneer bijvoorbeeld een negatief resultaat een fout aangeeft. Map<Class<?>, Object> dwingt niet af dat de waarde past bij het type dat de sleutel vertegenwoordigt; controleer dat vóór het opslaan met type.cast(value). Als een Lock een gedeelde map beschermt, gebruik dan diezelfde vergrendeling voor alle toegang: roep lock.lock() aan vóór try, schrijf binnen try en roep lock.unlock() aan in finally.
Voorbeelden
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());
}
}Resultaat
false null ready true null done 1
De eerste `null` die `put` teruggeeft, betekent dat de sleutel ontbrak. De gelijke sleutel vervangt `ready` door `null` zonder het item te verwijderen. De tweede `null` die `put` teruggeeft, is de vorige waarde; de map bevat nog steeds maar één item.
Gerelateerde lessen
- Java · Les 13 · Gevorderd · Versie: 2
- Java · Les 17 · Gevorderd · Versie: 2
- Java · Les 18 · Gevorderd · Versie: 2
- Java · Les 20 · Gevorderd · Versie: 2
- Java · Les 36 · Gevorderd · Versie: 2
- Java · Les 35 · Basis · Versie: 2
- Java · Les 42 · Basis · Versie: 2
- Java · Les 57 · Basis · Versie: 2
- Java · Les 58 · Basis · Versie: 2
- Java · Les 40 · Gemiddeld · Versie: 2
Bronnen
- 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)