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

CKTIS / Java

Map.entrySet() : parcourir les paires clé-valeur

Utilisez `entrySet()` si chaque tour de boucle nécessite à la fois la clé et la valeur associée. Cette méthode renvoie une vue de la map, pas une copie.

Version : Java SE 21

Syntaxe

Set<Map.Entry<K, V>> entries = map.entrySet();
for (Map.Entry<K, V> entry : entries) {
    K key = entry.getKey();
    V value = entry.getValue();
}

Map.entrySet désigne une méthode d’instance sans argument de java.util.Map<K, V>. La notation Map.entrySet() désigne la même méthode avec une liste d’arguments vide ; dans le code, appelez-la sur une instance avec map.entrySet(). Elle renvoie un Set<Map.Entry<K, V>> contenant une entrée par association.

Map.Entry<K, V> est une interface imbriquée dans Map. Dans une boucle for améliorée, appelez entry.getKey() pour lire la clé de type K et entry.getValue() pour lire la valeur de type V de chaque entrée. Inutile d’appeler aussi map.get(key). Utilisez keySet() si vous n’avez besoin que des clés, ou values() si vous n’avez besoin que des valeurs.

L’ensemble est une vue liée à la map, pas un instantané : les modifications de la map se reflètent dans la vue, et une suppression effectuée via la vue, si elle est prise en charge, supprime aussi l’association de la map. add et addAll ne sont pas pris en charge. Selon le contrat général de Map, modifier la map pendant le parcours rend son résultat indéfini, sauf si l’on utilise une opération prise en charge : Iterator.remove() sur l’itérateur utilisé ou setValue(...) sur une entrée renvoyée par cet itérateur. Ne vous fiez pas au comportement d’une telle entrée après le parcours.

entrySet() ne trie pas les entrées. L’ordre de parcours dépend de l’implémentation de la map. Dans l’exemple, new TreeMap<>(counts) crée une map distincte avec les mêmes associations, dans l’ordre naturel des clés. La boucle parcourt la vue de cette copie.

Exemples

import java.util.Map;
import java.util.TreeMap;
import java.util.stream.Collectors;
import java.util.stream.Stream;

public class Main {
    public static void main(String[] args) {
        Map<String, Long> counts = Stream.of("pear", "apple", "plum", "apple", "kiwi", "banana", "pear")
                .collect(Collectors.groupingBy(fruit -> fruit, Collectors.counting()));
        Map<String, Long> sorted = new TreeMap<>(counts);

        for (Map.Entry<String, Long> entry : sorted.entrySet()) {
            System.out.println(entry.getKey() + " = " + entry.getValue());
        }
    }
}

Résultat

apple = 2
banana = 1
kiwi = 1
pear = 2
plum = 1

`collect(...)` compte les occurrences de chaque nom de fruit. Une fois cette opération terminée, le code crée la copie `TreeMap` et affiche exactement cinq lignes, une par clé, dans l’ordre naturel des clés.

Leçons associées

  • Java · Leçon 24 · Avancé · Version : 2
  • Java · Leçon 57 · Débutant · Version : 2
  • Java · Leçon 67 · Débutant · Version : 2
  • Java · Leçon 39 · Intermédiaire · Version : 2

Sources