CKTIS / Java
Map.put — umetanje ili zamjena vrijednosti
Spremite vrijednost pod ključem i dohvatite prethodnu vrijednost. Rezultat `null` može značiti da ključa nije bilo ili da je već imao vrijednost `null`.
Verzija: Java SE 21
Sintaksa
V put(K key, V value)
V previous = map.put(key, value);Map.put je instancijska metoda sučelja java.util.Map<K, V> u Java SE 21. Zapis Map.put() skraćeno je ime iste metode, a ne poziv bez argumenata. Pozovite map.put(key, value) s ključem tipa K i vrijednošću tipa V. Ako ključa nema, metoda dodaje unos; inače zamjenjuje njegovu vrijednost. U HashMap dva različita objekta ključa označavaju isti unos ako su jednaka prema equals i imaju isti hashCode.
Metoda vraća prethodnu vrijednost, a ne novu. Rezultat null znači da unosa nije bilo ili da je prethodna vrijednost bila null, ako mapa to dopušta. Provjerite containsKey(key) prije upisa kako biste razlikovali te slučajeve, pod uvjetom da se mapa između operacija ne promijeni. Spremanje vrijednosti null ne uklanja unos.
put je neobavezna operacija. Mapa stvorena pomoću Map.of baca UnsupportedOperationException. Mapa može odbiti nedopušteni null iznimkom NullPointerException, neprikladan tip iznimkom ClassCastException ili nedopušteno svojstvo ključa ili vrijednosti iznimkom IllegalArgumentException. Upis kroz promjenjivi pogled NavigableMap.subMap mijenja izvornu mapu; ključ izvan raspona izaziva IllegalArgumentException i ne umeće se.
HashMap i WeakHashMap dopuštaju ključ null i vrijednosti null. Unos u WeakHashMap može nestati i kad sakupljač otpada ukloni njegov slabo dohvatljiv ključ. Nakon što put umetne novi unos u LinkedHashMap, mapa automatski poziva removeEldestEntry. Nadjačana metoda može vratiti true kako bi se najstariji unos uklonio. Sama zamjena vrijednosti ne pokreće taj poziv.
Ako predmemorija treba čuvati samo valjane rezultate, preskočite put kada, primjerice, negativan rezultat označava pogrešku. Map<Class<?>, Object> ne jamči da vrijednost odgovara tipu koji ključ predstavlja; provjerite to prije spremanja pomoću type.cast(value). Ako Lock štiti dijeljenu mapu, koristite istu bravu za svaki pristup: pozovite lock.lock() prije try, pišite unutar try i pozovite lock.unlock() u finally.
Primjeri
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());
}
}Rezultat
false null ready true null done 1
Prvi `null` koji vrati `put` znači da ključa nije bilo. Jednak ključ zamjenjuje `ready` vrijednošću `null` bez uklanjanja unosa. Drugi `null` koji vrati `put` prethodna je vrijednost, a mapa i dalje ima samo jedan unos.
Povezane lekcije
- Java · Lekcija 13 · Napredno · Verzija: 2
- Java · Lekcija 17 · Napredno · Verzija: 2
- Java · Lekcija 18 · Napredno · Verzija: 2
- Java · Lekcija 20 · Napredno · Verzija: 2
- Java · Lekcija 36 · Napredno · Verzija: 2
- Java · Lekcija 35 · Osnovno · Verzija: 2
- Java · Lekcija 42 · Osnovno · Verzija: 2
- Java · Lekcija 57 · Osnovno · Verzija: 2
- Java · Lekcija 58 · Osnovno · Verzija: 2
- Java · Lekcija 40 · Srednje · Verzija: 2
Izvori
- 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)