Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Map.values() — pohled na hodnoty mapy

`Map.values()` vrací kolekci propojenou s mapou. Můžeš ji projít a sečíst počítadla bez vyhledávání jejich klíčů a bez vynechávání opakovaných hodnot.

Verze: Java SE 21

Syntaxe

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

Map.values je zkrácené označení pro Map.values(), instanční metodu rozhraní java.util.Map<K, V>. Zavolej ji na mapě bez argumentů: map.values(). Vrátí Collection<V> (V je typ hodnot) s jedním prvkem na každý záznam. Stejné hodnoty u různých klíčů se objeví vícekrát. Pro klíče použij keySet(), pro dvojice klíč–hodnota entrySet().

Jde o pohled, ne o kopii: přidání, nahrazení nebo odebrání záznamu v mapě se projeví i v dříve získaném pohledu. Pokud je odebírání podporováno, values.remove(x) odebere jeden odpovídající záznam podle hodnoty, ne podle klíče. Chceš-li odebrat konkrétní klíč, použij map.remove(key). Pohled nepodporuje add ani addAll. Nepodporovaná změna může vyvolat UnsupportedOperationException.

Nespoléhej na pořadí průchodu: HashMap žádné nezaručuje. Pohled na hodnoty LinkedHashMap se řídí aktuálním pořadím průchodu záznamy mapy. Konstruktor bez argumentů ve výchozím nastavení volí pořadí vkládání, ale putFirst a putLast mohou přesunout existující záznamy. Při průchodu pohledem mapu neměň s výjimkou volání remove() na témže iterátoru, pokud je tato operace podporována. Jinak obecná specifikace Map výsledek průchodu nedefinuje.

Pokud potřebuješ jen hodnoty, třeba k sečtení čtyř počítadel, stačí cyklus for-each. Pokud pozdější změny v mapě nemají měnit prvky kolekce, použij new ArrayList<>(map.values()). Jde o mělkou kopii: objekty použité jako hodnoty se neklonují.

Příklady

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

Výsledek

17
20
false

První součet (`17`) zahrnuje obě hodnoty `4`. Po změně hodnoty u `west` z `2` na `5` dává tentýž pohled `20`. `values.remove(7)` odebere záznam pro `south`, jediný s hodnotou `7`, takže kontrola klíče vypíše `false`.

Související lekce

  • Java · Lekce 58 · Základní · Verze: 2
  • Java · Lekce 39 · Středně pokročilá · Verze: 2

Zdroje