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

CKTIS / Java

Map.Entry — um par chave-valor

Map.Entry<K,V> representa um único par chave-valor. O método getKey() lê a chave e getValue() lê o valor. Uma entrada pode estar associada a um mapa ou existir independentemente dele.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

Map.Entry<K,V> é uma interface aninhada em Map que representa um único par chave-valor, e não um mapa inteiro. K indica o tipo da chave e V o tipo do valor. Map.Entry.getKey() devolve a chave como K; Map.Entry.getValue() devolve o valor como V. Ambos os métodos não recebem argumentos.

Ao iterar sobre map.entrySet(), pode ler os dois componentes de cada entrada. Não considere uma entrada obtida desta forma uma cópia permanente: o seu comportamento não está definido fora da iteração ou depois de modificar o mapa, exceto no caso de uma alteração suportada através de setValue() durante a iteração.

Map.entry(key, value) cria, como no exemplo, uma entrada não modificável e independente de qualquer mapa. Rejeita chaves e valores null; chamar setValue() lança UnsupportedOperationException. Em geral, o suporte de setValue() depende da implementação da entrada.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes