Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Map.put — insérer ou remplacer une valeur

Associez une valeur à une clé et récupérez la valeur précédente. Un retour `null` peut signaler une clé absente ou une clé déjà associée à `null`.

Version : Java SE 21

Syntaxe

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

Map.put est une méthode d’instance de java.util.Map<K, V> dans Java SE 21. Map.put() est une notation abrégée pour cette même méthode, pas un appel sans argument. Appelez map.put(key, value) avec une clé de type K et une valeur de type V. La méthode ajoute une entrée si la clé est absente ; sinon, elle remplace la valeur associée. Dans une HashMap, deux objets clés distincts désignent la même entrée s’ils sont égaux selon equals et ont le même hashCode.

La méthode renvoie la valeur précédente, pas la nouvelle. Un retour null signifie soit qu’il n’existait aucune entrée, soit que la valeur précédente était null, si la map l’autorise. Vérifiez containsKey(key) avant l’écriture pour distinguer ces deux cas, à condition que la map ne change pas entre les opérations. Stocker null comme valeur ne supprime pas l’entrée.

put est une opération facultative. Une map créée par Map.of lève UnsupportedOperationException. Une map peut rejeter un null interdit avec NullPointerException, un type incompatible avec ClassCastException ou une propriété non admise d’une clé ou d’une valeur avec IllegalArgumentException. Écrire via une vue modifiable de NavigableMap.subMap modifie la map sous-jacente ; une clé hors de l’intervalle provoque une IllegalArgumentException et n’est pas insérée.

HashMap et WeakHashMap acceptent une clé null et des valeurs null. Une entrée de WeakHashMap peut aussi disparaître lorsque le ramasse-miettes récupère sa clé faiblement accessible. Après l’insertion d’une nouvelle entrée par put dans une LinkedHashMap, la map appelle automatiquement removeEldestEntry. Une redéfinition peut renvoyer true pour évincer l’entrée la plus ancienne. Un simple remplacement de valeur ne déclenche pas cet appel.

Si un cache ne doit conserver que des résultats valides, n’appelez pas put lorsqu’un résultat négatif signale une erreur, par exemple. Map<Class<?>, Object> ne garantit pas que la valeur corresponde au type représenté par sa clé : vérifiez-le avec type.cast(value) avant de la stocker. Si un Lock protège une map partagée, utilisez le même verrou pour tous les accès : appelez lock.lock() avant try, écrivez dans try, puis appelez lock.unlock() dans finally.

Exemples

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

Résultat

false
null
ready
true
null
done
1

Le premier `null` renvoyé par `put` indique que la clé était absente. La clé égale remplace `ready` par `null` sans supprimer l’entrée. Le deuxième `null` renvoyé par `put` est la valeur précédente, et la map ne contient toujours qu’une seule entrée.

Leçons associées

  • Java · Leçon 13 · Avancé · Version : 2
  • Java · Leçon 17 · Avancé · Version : 2
  • Java · Leçon 18 · Avancé · Version : 2
  • Java · Leçon 20 · Avancé · Version : 2
  • Java · Leçon 36 · Avancé · Version : 2
  • Java · Leçon 35 · Débutant · Version : 2
  • Java · Leçon 42 · Débutant · Version : 2
  • Java · Leçon 57 · Débutant · Version : 2
  • Java · Leçon 58 · Débutant · Version : 2
  • Java · Leçon 40 · Intermédiaire · Version : 2

Sources