Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Map.entrySet(): iteracja po parach klucz–wartość

Użyj `entrySet()`, gdy w każdym kroku pętli potrzebujesz zarówno klucza, jak i odpowiadającej mu wartości. Metoda zwraca widok mapy, a nie jej kopię.

Wersja: Java SE 21

Składnia

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 to nazwa metody instancji bez argumentów z interfejsu java.util.Map<K, V>. Zapis Map.entrySet() wskazuje tę samą metodę wraz z jej pustą listą argumentów; w kodzie wywołujesz ją na obiekcie mapy jako map.entrySet(). Wynikiem jest Set<Map.Entry<K, V>> z jednym wpisem dla każdego powiązania klucza z wartością.

Map.Entry<K, V> jest interfejsem zagnieżdżonym w Map. Na każdym wpisie z pętli for typu for-each wywołaj entry.getKey(), aby odczytać klucz typu K, oraz entry.getValue(), aby odczytać wartość typu V. Nie potrzebujesz dodatkowego map.get(key). Jeśli interesują Cię tylko klucze, użyj keySet(), a jeśli tylko wartości — values().

Zbiór jest widokiem powiązanym z mapą, nie migawką: zmiany mapy są w nim widoczne, a usunięcie wpisu przez widok, jeśli jest obsługiwane, usuwa też powiązanie z mapy. add i addAll nie są obsługiwane. Zgodnie z ogólnym kontraktem Map wynik iteracji po modyfikacji mapy w jej trakcie jest nieokreślony, z wyjątkiem obsługiwanych operacji Iterator.remove() na używanym iteratorze i setValue(...) na wpisie zwróconym przez ten iterator. Nie polegaj na zachowaniu takiego wpisu po zakończeniu iteracji.

entrySet() samo nie sortuje wpisów. Kolejność iteracji zależy od implementacji mapy. W przykładzie new TreeMap<>(counts) tworzy osobną mapę z tymi samymi powiązaniami, uporządkowaną według naturalnego porządku kluczy. Pętla przechodzi po widoku tej kopii.

Przykłady

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());
        }
    }
}

Wynik

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

Wywołanie `collect(...)` zlicza wystąpienia poszczególnych nazw owoców. Dopiero po jego zakończeniu kod tworzy kopię `TreeMap` i wypisuje dokładnie pięć wierszy, po jednym na klucz, w naturalnej kolejności kluczy.

Powiązane lekcje

  • Java · Lekcja 24 · Zaawansowany · Wersja: 2
  • Java · Lekcja 57 · Podstawowy · Wersja: 2
  • Java · Lekcja 67 · Podstawowy · Wersja: 2
  • Java · Lekcja 39 · Średniozaawansowany · Wersja: 2

Źródła