CKTIS / Java
Map.Entry — ein Schlüssel-Wert-Paar
Map.Entry<K,V> stellt ein einzelnes Schlüssel-Wert-Paar dar. Mit getKey() wird der Schlüssel ausgelesen, mit getValue() der Wert. Ein Eintrag kann mit einer Map verbunden sein oder unabhängig von ihr bestehen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Map.Entry<K, V> entry = Map.entry(key, value);
K keyResult = entry.getKey();
V valueResult = entry.getValue();Map.Entry<K,V> ist eine in Map verschachtelte Schnittstelle, die ein einzelnes Schlüssel-Wert-Paar und nicht eine ganze Map darstellt. K gibt den Schlüsseltyp an, V den Werttyp. Map.Entry.getKey() gibt den Schlüssel als K zurück; Map.Entry.getValue() gibt den Wert als V zurück. Beide Methoden benötigen keine Argumente.
Bei der Iteration über map.entrySet() können Sie beide Bestandteile jedes Eintrags auslesen. Betrachten Sie einen so erhaltenen Eintrag nicht als dauerhafte Kopie: Außerhalb der Iteration oder nach einer Änderung der Map ist sein Verhalten nicht definiert. Ausgenommen ist eine unterstützte Änderung durch setValue() während der Iteration.
Map.entry(key, value) erstellt wie im Beispiel einen unveränderbaren Eintrag, der unabhängig von einer Map ist. null-Schlüssel und -Werte werden abgelehnt; ein Aufruf von setValue() löst UnsupportedOperationException aus. Allgemein hängt die Unterstützung von setValue() von der Implementierung des Eintrags ab.
Beispiele
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);
}
}Ergebnis
points = 42
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.