CKTIS / Java
Map.put — добавяне или замяна на стойност
Запишете стойност за даден ключ и получете предишната стойност. Резултатът `null` може да означава, че ключът е липсвал или вече е сочел към `null`.
Версия: Java SE 21
Синтаксис
V put(K key, V value)
V previous = map.put(key, value);Map.put е метод на екземпляр от интерфейса java.util.Map<K, V> в Java SE 21. Записът Map.put() е кратко название на същия метод, а не извикване без аргументи. Извикайте map.put(key, value) с ключ от тип K и стойност от тип V. Ако ключът липсва, методът добавя запис; иначе заменя стойността му. В HashMap два различни обекта, използвани като ключове, обозначават един и същ запис, ако са равни според equals и имат еднакъв hashCode.
Методът връща предишната стойност, а не новата. Резултатът null означава, че не е имало запис или че предишната стойност е била null, ако реализацията я допуска. Проверете с containsKey(key) преди запис, за да разграничите двата случая, при условие че речникът (Map) не се променя между операциите. Записването на null като стойност не премахва записа.
put е незадължителна операция. Извикването на put върху речник, създаден чрез Map.of, води до UnsupportedOperationException. Реализацията може да отхвърли недопустимо null с NullPointerException, неподходящ тип с ClassCastException или недопустимо свойство на ключ или стойност с IllegalArgumentException. Записването през изменяем изглед от NavigableMap.subMap променя основния речник; ключ извън диапазона предизвиква IllegalArgumentException и не се добавя.
HashMap и WeakHashMap допускат ключ null и стойности null. Запис в WeakHashMap може да изчезне и когато механизмът за автоматично освобождаване на паметта освободи слабо достижимия му ключ. След като put добави нов запис в LinkedHashMap, речникът автоматично извиква removeEldestEntry. Предефиниран метод може да върне true, за да бъде премахнат най-старият запис. Само замяната на стойност не води до това извикване.
Ако кешът трябва да пази само валидни резултати, пропуснете put, когато например отрицателен резултат означава грешка. Map<Class<?>, Object> не гарантира, че стойността съответства на типа, представен от ключа; проверете това с type.cast(value) преди запис. Ако Lock защитава споделен речник, използвайте същото заключване при всеки достъп: извикайте lock.lock() преди try, записвайте в try и извикайте lock.unlock() във finally.
Примери
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());
}
}Резултат
false null ready true null done 1
Първото `null`, върнато от `put`, означава, че ключът е липсвал. Равният ключ заменя `ready` с `null`, без да премахва записа. Второто `null`, върнато от `put`, е предишната стойност, а речникът все още съдържа само един запис.
Свързани уроци
- Java · Урок 13 · Напреднало · Версия: 2
- Java · Урок 17 · Напреднало · Версия: 2
- Java · Урок 18 · Напреднало · Версия: 2
- Java · Урок 20 · Напреднало · Версия: 2
- Java · Урок 36 · Напреднало · Версия: 2
- Java · Урок 35 · Начално · Версия: 2
- Java · Урок 42 · Начално · Версия: 2
- Java · Урок 57 · Начално · Версия: 2
- Java · Урок 58 · Начално · Версия: 2
- Java · Урок 40 · Средно · Версия: 2
Източници
- 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)