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

CKTIS / Java

Map.put — insertar o reemplazar un valor

Asocia un valor a una clave y recupera el valor anterior. Un retorno de `null` puede indicar que la clave no existía o que estaba asociada a `null`.

Versión: Java SE 21

Sintaxis

V put(K key, V value)
V previous = map.put(key, value);

Map.put es un método de instancia de java.util.Map<K, V> en Java SE 21. Map.put() es una forma abreviada de nombrar el mismo método, no una llamada sin argumentos. Llama a map.put(key, value) con una clave de tipo K y un valor de tipo V. Si no existe la clave, se añade una entrada; si ya existe, se reemplaza su valor. En un HashMap, dos objetos clave distintos identifican la misma entrada si son iguales según equals y tienen el mismo hashCode.

El método devuelve el valor anterior, no el nuevo. Un resultado null significa que no había ninguna entrada o que el valor anterior era null, si el mapa lo admite. Consulta containsKey(key) antes de escribir para distinguir ambos casos, siempre que el mapa no cambie entre las operaciones. Guardar null como valor no elimina la entrada.

put es una operación opcional. Un mapa creado con Map.of lanza UnsupportedOperationException. Un mapa puede rechazar un null no permitido con NullPointerException, un tipo inadecuado con ClassCastException o una propiedad no permitida de la clave o del valor con IllegalArgumentException. Escribir mediante una vista modificable de NavigableMap.subMap cambia el mapa subyacente; una clave fuera del intervalo provoca IllegalArgumentException y no se inserta.

HashMap y WeakHashMap admiten una clave null y valores null. Una entrada de WeakHashMap también puede desaparecer cuando el recolector de basura recupera su clave, que solo es alcanzable mediante referencias débiles. Cuando put inserta una entrada nueva en un LinkedHashMap, el mapa llama automáticamente a removeEldestEntry. Una redefinición puede devolver true para expulsar la entrada más antigua. Reemplazar un valor sin insertar una entrada no activa esa llamada.

Si una caché solo debe guardar resultados válidos, omite put cuando, por ejemplo, un resultado negativo indique un error. Map<Class<?>, Object> no exige que el valor coincida con el tipo representado por la clave; compruébalo con type.cast(value) antes de guardarlo. Si un Lock protege un mapa compartido, usa el mismo bloqueo en todos los accesos: llama a lock.lock() antes de try, escribe dentro de try y llama a lock.unlock() en finally.

Ejemplos

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

public class Main {
    public static void main(String[] args) {
        Map<String, String> statuses = new HashMap<>();
        String key = "job";
        String equalKey = new String(key);

        System.out.println(statuses.containsKey(key));
        System.out.println(statuses.put(key, "ready"));
        System.out.println(statuses.put(equalKey, null));
        System.out.println(statuses.containsKey(key));
        System.out.println(statuses.put(key, "done"));
        System.out.println(statuses.get(key));
        System.out.println(statuses.size());
    }
}

Resultado

false
null
ready
true
null
done
1

El primer `null` devuelto por `put` indica que la clave no existía. La clave igual reemplaza `ready` por `null` sin eliminar la entrada. El segundo `null` devuelto por `put` es el valor anterior, y el mapa sigue teniendo una sola entrada.

Lecciones relacionadas

  • Java · Lección 13 · Avanzado · Versión: 2
  • Java · Lección 17 · Avanzado · Versión: 2
  • Java · Lección 18 · Avanzado · Versión: 2
  • Java · Lección 20 · Avanzado · Versión: 2
  • Java · Lección 36 · Avanzado · Versión: 2
  • Java · Lección 35 · Básico · Versión: 2
  • Java · Lección 42 · Básico · Versión: 2
  • Java · Lección 57 · Básico · Versión: 2
  • Java · Lección 58 · Básico · Versión: 2
  • Java · Lección 40 · Intermedio · Versión: 2

Fuentes