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

CKTIS / Java

java.util.Map — associer des clés à des valeurs

Map<K,V> associe chaque clé à une seule valeur au maximum. Découvrez la recherche, les mises à jour, le calcul de valeurs et les vues d’une map, en prêtant une attention particulière à la gestion de null et aux garanties de l’implémentation.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

Map<K, V> map = new HashMap<>();

java.util.Map<K,V> est une interface qui associe des clés à des valeurs ; les valeurs peuvent se répéter. HashMap ne garantit aucun ordre, tandis que TreeMap trie les clés. La prise en charge de null dépend de l’implémentation. Ne modifiez pas une clé stockée d’une manière qui affecte sa comparaison.

Map.put(k, v) ajoute ou remplace une valeur et renvoie la précédente ; Map.remove(k) supprime une entrée et renvoie son ancienne valeur. Les deux renvoient aussi null si l’entrée est absente. Map.get(k) renvoie la valeur ou null ; Map.containsKey(k) distingue une absence d’une valeur associée égale à null. Map.getOrDefault(k, d) renvoie d uniquement en cas d’absence, et non lorsqu’une valeur associée est null. Map.size() compte les entrées ; Map.containsValue(v) vérifie si une valeur est présente.

Map.compute(k, f) transmet à la fonction la clé et la valeur actuelle, ou null ; un résultat null supprime l’entrée ou la laisse absente. Map.computeIfAbsent(k, f) appelle la fonction si l’entrée est absente ou si sa valeur est null ; seul un résultat non nul est enregistré. Map.merge(k, v, f) exige v != null : si l’entrée est absente ou sa valeur null, v est enregistré ; sinon, l’ancienne valeur est combinée avec v. Un résultat null supprime l’entrée.

Map.keySet() expose un ensemble de clés, Map.values() une collection de valeurs et Map.entrySet() un ensemble de paires Map.Entry<K,V>. Ce sont des vues liées à la map, et non des copies ; une suppression par une vue supprime l’entrée si l’opération est prise en charge. Map.forEach(action) parcourt chaque paire.

Les opérations de modification peuvent déclencher UnsupportedOperationException. Les fonctions de calcul ne doivent pas modifier la même map. Les méthodes par défaut de Map ne garantissent ni l’atomicité ni la synchronisation. L’exemple utilise TreeMap pour obtenir un ordre de sortie déterministe.

Exemples

import java.util.Map;
import java.util.TreeMap;

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> counts = new TreeMap<>();
        counts.put("pear", 1);
        counts.merge("pear", 2, Integer::sum);
        counts.computeIfAbsent("apple", key -> 1);
        counts.compute("apple", (key, value) -> value + 1);
        System.out.println(counts.get("pear"));
        System.out.println(counts.getOrDefault("plum", 0));
        System.out.println(counts.containsKey("plum"));
        System.out.println(counts.containsValue(2));
        System.out.println(counts.size());
        System.out.println(counts.keySet());
        System.out.println(counts.values());
        System.out.println(counts.entrySet());
        counts.forEach((key, value) -> System.out.println(key + ":" + value));
        System.out.println(counts.remove("pear"));
        System.out.println(counts.size());
    }
}

Résultat

3
0
false
true
2
[apple, pear]
[2, 3]
[apple=2, pear=3]
apple:2
pear:3
3
1

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources