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

CKTIS / Java

Map.get — lire une valeur à partir de sa clé

Utilisez `map.get(key)` pour lire une valeur stockée. Si la map accepte les valeurs `null`, le résultat seul ne distingue pas une clé absente d’une clé associée à `null`.

Version : Java SE 21

Syntaxe

V get(Object key);  // instance method declared by java.util.Map<K, V>
map.get(key)       // call with one key argument

Dans Java SE 21, Map.get est une méthode d’instance de java.util.Map<K, V>, déclarée V get(Object key). Map.get() est une notation abrégée, pas une surcharge sans argument : appelez map.get(key). La méthode renvoie la valeur stockée, ou null si l’association est absente. Le contrat de Map décrit la correspondance par Objects.equals(key, k), où k est la clé stockée. Dans une HashMap, une autre instance de clé, égale à la première, peut retrouver la même entrée. Deux clés égales selon equals doivent avoir le même hashCode. Ne modifiez pas les propriétés qui déterminent l’égalité d’une clé tant qu’elle est dans la map.

Avec Map<Integer, Long>, Long total = totals.get(7); récupère une valeur déjà calculée sans conversion explicite. Le paramètre est de type Object, et non K. Un Map de type brut, sans arguments de type, renvoie un Object. Pour affecter ce résultat à une variable de type String ou Integer, utilisez un cast explicite, comme (String) raw.get(key) ou (Integer) raw.get(key). Si la valeur est incompatible et non null, le cast déclenche une ClassCastException. Préférez les maps paramétrées.

Si la map accepte les valeurs null, get ne distingue pas une clé absente d’une clé associée à null. Testez la présence avec containsKey(key) ; en cas de modification concurrente, les deux appels ne constituent pas une opération atomique. getOrDefault(key, fallback) ne renvoie fallback qu’en l’absence d’association. Selon l’implémentation, un type de clé inadapté peut déclencher une ClassCastException et une clé null interdite peut déclencher une NullPointerException. Pour lire les valeurs true et false stockées, indiquez leurs clés sans dépendre de l’ordre d’itération. Convertir par déballage un résultat null, par exemple de Boolean à boolean, déclenche une NullPointerException.

Dans une LinkedHashMap ordonnée par accès (accessOrder = true dans le constructeur), une recherche réussie place l’entrée en fin d’itération, même si sa valeur est null. Une recherche sans résultat ne change pas l’ordre. Dans le mode par ordre d’insertion, get ne modifie pas l’ordre.

Si plusieurs threads écrivent des résultats, utilisez par exemple une ConcurrentHashMap, qui refuse les clés et valeurs null. Après le retour réussi de join() pour chaque thread de travail, le thread principal voit leurs écritures. Consultez les résultats par indice de requête croissant pour respecter l’ordre des requêtes plutôt que leur ordre d’achèvement. join() ne sécurise pas des écritures concurrentes antérieures dans une HashMap ordinaire.

Exemples

import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.Map;

public class MapGetDemo {
    record Key(int id) {}

    public static void main(String[] args) {
        Map<Key, Long> totals = new HashMap<>();
        totals.put(new Key(7), 6L * 7);
        totals.put(new Key(8), null);
        Long total = totals.get(new Key(7));
        System.out.println("total: " + total);
        for (int id : new int[] {8, 9}) {
            Key key = new Key(id);
            System.out.println(id + ": " + totals.get(key) + ", present: " + totals.containsKey(key));
        }

        Map<String, Boolean> flags = Map.of("a", true, "b", false);
        System.out.println("flags: " + flags.get("a") + ", " + flags.get("b"));

        Map<String, Integer> recent = new LinkedHashMap<>(16, 0.75f, true);
        recent.put("a", 1);
        recent.put("b", 2);
        System.out.println("before: " + recent.keySet());
        System.out.println("get a: " + recent.get("a"));
        System.out.println("after: " + recent.keySet());
    }
}

Résultat

total: 42
8: null, present: true
9: null, present: false
flags: true, false
before: [a, b]
get a: 1
after: [b, a]

Un nouveau `Key(7)` retrouve la valeur `42`. Pour `8` et `9`, `get` renvoie `null`, mais seule la clé `8` est présente. Les indicateurs sont lus explicitement pour `a`, puis `b`. Dans la dernière map, consulter `a` fait passer l’ordre de `[a, b]` à `[b, a]`.

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 36 · Avancé · Version : 2
  • Java · Leçon 35 · Débutant · Version : 2
  • Java · Leçon 42 · Débutant · Version : 2
  • Java · Leçon 58 · Débutant · Version : 2
  • Java · Leçon 40 · Intermédiaire · Version : 2
  • Java · Leçon 43 · Intermédiaire · Version : 2

Sources