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

CKTIS / Java

Map.Entry — un par clave-valor

Map.Entry<K,V> representa un único par clave-valor. El método getKey() lee la clave y getValue() lee el valor. Una entrada puede estar vinculada a un mapa o existir independientemente de él.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

Map.Entry<K, V> entry = Map.entry(key, value);
K keyResult = entry.getKey();
V valueResult = entry.getValue();

Map.Entry<K,V> es una interfaz anidada en Map que representa un único par clave-valor, no un mapa completo. K indica el tipo de la clave y V, el tipo del valor. Map.Entry.getKey() devuelve la clave como K; Map.Entry.getValue() devuelve el valor como V. Ninguno de los dos métodos recibe argumentos.

Al iterar sobre map.entrySet(), puedes leer los dos componentes de cada entrada. No consideres una entrada obtenida de esta forma como una copia permanente: su comportamiento no está definido fuera de la iteración o después de modificar el mapa, salvo por un cambio admitido mediante setValue() durante la iteración.

Map.entry(key, value) crea, como en el ejemplo, una entrada no modificable e independiente de cualquier mapa. Rechaza las claves y los valores null; llamar a setValue() provoca UnsupportedOperationException. En general, la compatibilidad con setValue() depende de la implementación de la entrada.

Ejemplos

import java.util.Map;

public class Main {
    public static void main(String[] args) {
        Map.Entry<String, Integer> entry = Map.entry("points", 42);
        String key = entry.getKey();
        Integer value = entry.getValue();
        System.out.println(key + " = " + value);
    }
}

Resultado

points = 42

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes