Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Map.values() — widok wartości mapy

`Map.values()` zwraca powiązaną z mapą kolekcję wartości. Można po niej iterować, aby zsumować liczniki bez odczytywania kluczy i bez pomijania powtórzeń.

Wersja: Java SE 21

Składnia

Collection<V> values();
// For an instance map of type Map<K, V>:
Collection<V> values = map.values();

Map.values to skrócony zapis nazwy metody instancyjnej Map.values() z interfejsu java.util.Map<K, V>. Wywołaj ją bez argumentów na obiekcie mapy: map.values(). Wynik ma typ Collection<V> (gdzie V jest typem wartości) i zawiera po jednym elemencie na każdy wpis. Różne klucze mogą mieć równe wartości, więc takie wartości występują wielokrotnie. Użyj keySet(), gdy potrzebujesz kluczy, a entrySet(), gdy potrzebujesz par klucz–wartość.

To widok, nie kopia: dodanie, zastąpienie lub usunięcie wpisu w mapie jest widoczne w już pobranej kolekcji. Jeśli usuwanie jest obsługiwane, values.remove(x) usuwa jeden pasujący wpis według wartości, nie klucza. Aby usunąć wpis o konkretnym kluczu, użyj map.remove(key). Widok nie obsługuje add ani addAll. Nieobsługiwana próba modyfikacji może zgłosić UnsupportedOperationException.

Nie zakładaj, że iteracja ma określoną kolejność: HashMap jej nie gwarantuje. Widok wartości LinkedHashMap odzwierciedla bieżącą kolejność wpisów w mapie. Konstruktor bez argumentów domyślnie wybiera kolejność wstawiania kluczy, ale putFirst i putLast mogą zmienić pozycję istniejących wpisów. Nie modyfikuj mapy w trakcie iteracji po widoku, chyba że używasz remove() tego samego iteratora i operacja jest obsługiwana. W przeciwnym razie ogólny kontrakt Map nie określa wyniku iteracji.

Gdy potrzebujesz wyłącznie wartości, na przykład do zsumowania czterech liczników, wystarczy pętla for-each. Jeśli późniejsze zmiany mapy nie mają zmieniać elementów kolekcji, użyj new ArrayList<>(map.values()). To płytka kopia: obiekty będące wartościami nie są klonowane.

Przykłady

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

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> counters = new HashMap<>();
        counters.put("north", 4);
        counters.put("south", 7);
        counters.put("east", 4);
        counters.put("west", 2);

        Collection<Integer> values = counters.values();
        System.out.println(sum(values));

        counters.put("west", 5);
        System.out.println(sum(values));

        values.remove(7);
        System.out.println(counters.containsKey("south"));
    }

    private static int sum(Collection<Integer> values) {
        int total = 0;
        for (int value : values) {
            total += value;
        }
        return total;
    }
}

Wynik

17
20
false

Pierwsza suma (`17`) uwzględnia obie wartości `4`. Po zmianie licznika `west` z `2` na `5` ten sam widok daje sumę `20`. `values.remove(7)` usuwa wpis `south`, jedyny o wartości `7`, więc sprawdzenie klucza wypisuje `false`.

Powiązane lekcje

  • Java · Lekcja 58 · Podstawowy · Wersja: 2
  • Java · Lekcja 39 · Średniozaawansowany · Wersja: 2

Źródła