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.