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

CKTIS / Java

Map.getOrDefault : lire une valeur avec un repli

Lis la valeur associée à une clé. La valeur par défaut est renvoyée uniquement si la clé n’a pas d’entrée, et non si elle est associée à `null`.

Version : Java SE 21

Syntaxe

java.util.Map<K, V>: default V getOrDefault(Object key, V defaultValue)
Call: map.getOrDefault(key, defaultValue)

Map.getOrDefault est une méthode d’instance par défaut de l’interface java.util.Map<K, V>, disponible depuis Java 8. La notation Map.getOrDefault() désigne la méthode ; ce n’est pas un appel sans argument. Utilise map.getOrDefault(key, defaultValue) : le paramètre de la clé est déclaré de type Object, et la valeur par défaut et le résultat sont de type V.

Si la clé a une entrée, la méthode renvoie la valeur stockée, même si elle vaut null, comme le permet HashMap. Elle ne renvoie la valeur par défaut qu’en l’absence d’entrée. La méthode n’insère ni ne remplace rien. Contrairement à get(key), qui renvoie null pour une clé absente, elle permet de fournir une valeur de repli. Java évalue l’expression de repli avant l’appel, même si sa valeur n’est pas utilisée.

Pour Map<String, Long>, utilise 0L : Java convertit automatiquement ce littéral long en Long (boxing). L’affectation du résultat à une variable long effectue la conversion inverse (unboxing) ; si le résultat vaut null, cette conversion lève une NullPointerException. Pour Map<String, Integer>, tu peux utiliser map.getOrDefault("TOTAL", 0).

Selon l’implémentation, un type de clé inadapté peut provoquer une ClassCastException, et une clé null peut provoquer une NullPointerException si la map ne l’autorise pas. L’implémentation par défaut ne garantit ni synchronisation ni atomicité ; consulte la documentation de la map utilisée.

Exemples

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

public class Main {
    public static void main(String[] args) {
        Map<String, Long> counts = new HashMap<>();
        counts.put("books", 7L);
        counts.put("pending", null);

        long books = counts.getOrDefault("books", 0L);
        long games = counts.getOrDefault("games", 0L);
        Long pending = counts.getOrDefault("pending", 0L);

        System.out.println(books);
        System.out.println(games);
        System.out.println(pending);
        System.out.println(counts.containsKey("games"));
    }
}

Résultat

7
0
null
false

`books` vaut `7`, tandis que l’absence de l’entrée `games` donne `0`. Le résultat pour `pending` vaut `null` et reste donc dans une variable de type `Long`. Le dernier `false` montre que la lecture n’a pas inséré `games`.

Leçons associées

  • Java · Leçon 43 · Avancé · Version : 2
  • Java · Leçon 56 · Débutant · Version : 2
  • Java · Leçon 39 · Intermédiaire · Version : 2

Sources