Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Map.Entry — para klucz–wartość

Map.Entry<K,V> reprezentuje jedną parę klucz–wartość. Metoda getKey() odczytuje klucz, a getValue() wartość. Wpis może być powiązany z mapą albo istnieć niezależnie od niej.

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

Składnia

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

Map.Entry<K,V> to interfejs zagnieżdżony w Map, reprezentujący jedną parę klucz–wartość, nie całą mapę. K określa typ klucza, a V typ wartości. Map.Entry.getKey() zwraca klucz typu K; Map.Entry.getValue() zwraca wartość typu V. Obie metody są bezargumentowe.

Podczas iteracji po map.entrySet() można odczytywać oba elementy każdego wpisu. Tak uzyskanego wpisu nie należy traktować jako trwałej kopii: poza iteracją lub po zmianie mapy jego zachowanie jest niezdefiniowane, z wyjątkiem obsługiwanej zmiany przez setValue() podczas iteracji.

Map.entry(key, value) tworzy niezależny od mapy, niemodyfikowalny wpis, jak w przykładzie. Odrzuca klucze i wartości null; wywołanie setValue() zgłasza UnsupportedOperationException. Ogólnie obsługa setValue() zależy od implementacji wpisu.

Przykłady

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

Wynik

points = 42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła