Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Map.Entry — una coppia chiave-valore

Map.Entry<K,V> rappresenta una singola coppia chiave-valore. Il metodo getKey() legge la chiave, mentre getValue() legge il valore. Una voce può essere collegata a una mappa oppure esistere indipendentemente da essa.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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

Map.Entry<K,V> è un’interfaccia annidata in Map che rappresenta una singola coppia chiave-valore, non un’intera mappa. K indica il tipo della chiave e V quello del valore. Map.Entry.getKey() restituisce la chiave come K; Map.Entry.getValue() restituisce il valore come V. Entrambi i metodi non accettano argomenti.

Durante l’iterazione su map.entrySet(), è possibile leggere entrambi gli elementi di ogni voce. Non considerare una voce ottenuta in questo modo una copia permanente: il suo comportamento non è definito al di fuori dell’iterazione o dopo aver modificato la mappa, tranne nel caso di una modifica supportata tramite setValue() durante l’iterazione.

Map.entry(key, value) crea, come nell’esempio, una voce non modificabile e indipendente da qualsiasi mappa. Rifiuta chiavi e valori null; una chiamata a setValue() genera UnsupportedOperationException. In generale, il supporto di setValue() dipende dall’implementazione della voce.

Esempi

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

Risultato

points = 42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti