Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Map.values() — vista dos valores de um mapa

`Map.values()` devolve uma coleção ligada ao mapa. Podes percorrê-la para somar contadores sem consultar as chaves nem descartar valores repetidos.

Versão: Java SE 21

Sintaxe

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

Map.values é uma forma abreviada de referir Map.values(), um método de instância de java.util.Map<K, V>. Chama-o sem argumentos num mapa: map.values(). Devolve uma Collection<V> (V é o tipo dos valores) com um elemento por associação. Valores iguais associados a chaves diferentes aparecem mais do que uma vez. Usa keySet() para as chaves e entrySet() para os pares chave-valor.

É uma vista, não uma cópia: adicionar, substituir ou remover uma associação no mapa altera também o que vês numa vista já obtida. Se a remoção for suportada, values.remove(x) remove uma associação que corresponda ao valor, não à chave. Para remover uma chave específica, usa map.remove(key). A vista não suporta add nem addAll. Uma alteração não suportada pode lançar UnsupportedOperationException.

Não assumas uma ordem de iteração: HashMap não garante nenhuma. A vista dos valores de um LinkedHashMap segue a ordem de iteração atual das entradas do mapa. O construtor sem argumentos escolhe, por predefinição, a ordem de inserção, mas putFirst e putLast podem mudar a posição de entradas existentes. Não alteres o mapa durante a iteração sobre a vista, a não ser através de remove() do próprio iterador, se for suportado. Caso contrário, o contrato geral de Map não define o resultado da iteração.

Se só precisares dos valores, por exemplo para somar quatro contadores, basta um ciclo for-each. Se quiseres que alterações posteriores ao mapa não mudem os elementos da coleção, usa new ArrayList<>(map.values()). É uma cópia superficial: os objetos usados como valores não são clonados.

Exemplos

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

Resultado

17
20
false

A primeira soma (`17`) inclui os dois valores `4`. Depois de `west` mudar de `2` para `5`, a mesma vista dá `20`. `values.remove(7)` remove a associação de `south`, a única com valor `7`, pelo que a verificação da chave escreve `false`.

Lições relacionadas

  • Java · Lição 58 · Básico · Versão: 2
  • Java · Lição 39 · Intermédio · Versão: 2

Fontes