Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Map.values() — vista de los valores de un mapa

`Map.values()` devuelve una colección vinculada al mapa. Puedes recorrerla para sumar contadores sin consultar sus claves ni descartar valores repetidos.

Versión: Java SE 21

Sintaxis

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

Map.values es una forma abreviada de referirse a Map.values(), un método de instancia de java.util.Map<K, V>. Llámalo sin argumentos sobre un mapa: map.values(). Devuelve una Collection<V> (V es el tipo de los valores) con un elemento por cada asociación. Los valores iguales asociados a claves distintas aparecen varias veces. Usa keySet() para las claves y entrySet() para los pares clave-valor.

Es una vista, no una copia: si añades, reemplazas o eliminas una asociación en el mapa, el cambio se refleja en una vista que ya hayas obtenido. Si se admite la eliminación, values.remove(x) elimina una asociación que coincida por valor, no por clave. Para eliminar una clave concreta, usa map.remove(key). La vista no admite add ni addAll. Una modificación no admitida puede lanzar UnsupportedOperationException.

No des por hecho que existe un orden de recorrido: HashMap no garantiza ninguno. La vista de valores de un LinkedHashMap sigue el orden de recorrido actual de las entradas del mapa. El constructor sin argumentos elige por defecto el orden de inserción, pero putFirst y putLast pueden cambiar la posición de entradas existentes. No modifiques el mapa durante el recorrido de la vista, salvo mediante remove() del propio iterador si está disponible. De lo contrario, el contrato general de Map deja sin definir el resultado del recorrido.

Si solo necesitas los valores, por ejemplo para sumar cuatro contadores, basta con un bucle for-each. Si no quieres que los cambios posteriores del mapa alteren qué elementos contiene la colección, usa new ArrayList<>(map.values()). Es una copia superficial: no clona los objetos que se usan como valores.

Ejemplos

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

La primera suma (`17`) cuenta los dos valores `4`. Tras cambiar `west` de `2` a `5`, la misma vista da `20`. `values.remove(7)` elimina la asociación de `south`, la única con valor `7`, así que la comprobación de la clave imprime `false`.

Lecciones relacionadas

  • Java · Lección 58 · Básico · Versión: 2
  • Java · Lección 39 · Intermedio · Versión: 2

Fuentes