WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Map.getOrDefault: Wert mit Ersatzwert abfragen

Lies den Wert zu einem Schlüssel aus einer Map. Der Ersatzwert wird nur zurückgegeben, wenn der Eintrag fehlt, nicht wenn der gespeicherte Wert `null` ist.

Version: Java SE 21

Syntax

java.util.Map<K, V>: default V getOrDefault(Object key, V defaultValue)
Call: map.getOrDefault(key, defaultValue)

Map.getOrDefault ist eine seit Java 8 verfügbare Default-Instanzmethode der Schnittstelle java.util.Map<K, V>. Map.getOrDefault() ist eine Kurzschreibweise für den Methodennamen und kein Aufruf ohne Argumente. Der Aufruf lautet map.getOrDefault(key, defaultValue): Der Schlüsselparameter ist als Object deklariert; Ersatzwert und Ergebnis haben den Typ V.

Gibt es einen Eintrag für den Schlüssel, liefert die Methode den gespeicherten Wert, auch wenn er wie bei einer HashMap null sein darf. Nur bei einem fehlenden Eintrag liefert sie den Ersatzwert. Die Methode fügt nichts ein und ersetzt nichts. Anders als bei get(key), das für einen fehlenden Schlüssel null liefert, kannst du hier einen Ersatzwert angeben. Java wertet den Ausdruck dafür vor dem Aufruf aus, auch wenn sein Wert nicht verwendet wird.

Verwende bei Map<String, Long> den Ausdruck 0L: Java wandelt dieses long-Literal durch Boxing in Long um. Bei der Zuweisung des Ergebnisses an eine long-Variable erfolgt Unboxing; ist das Ergebnis null, wird dabei eine NullPointerException ausgelöst. Bei Map<String, Integer> kannst du map.getOrDefault("TOTAL", 0) verwenden.

Je nach Implementierung kann ein ungeeigneter Schlüsseltyp zu einer ClassCastException führen. Ein null-Schlüssel kann eine NullPointerException auslösen, wenn die Map ihn nicht zulässt. Die Default-Implementierung garantiert weder Synchronisierung noch Atomarität. Prüfe die Dokumentation der konkreten Map.

Beispiele

import java.util.HashMap;
import java.util.Map;

public class Main {
    public static void main(String[] args) {
        Map<String, Long> counts = new HashMap<>();
        counts.put("books", 7L);
        counts.put("pending", null);

        long books = counts.getOrDefault("books", 0L);
        long games = counts.getOrDefault("games", 0L);
        Long pending = counts.getOrDefault("pending", 0L);

        System.out.println(books);
        System.out.println(games);
        System.out.println(pending);
        System.out.println(counts.containsKey("games"));
    }
}

Ergebnis

7
0
null
false

`books` hat den Wert `7`; für den fehlenden Eintrag `games` erhältst du `0`. Das Ergebnis für `pending` ist `null` und bleibt deshalb in einer `Long`-Variablen. Das abschließende `false` zeigt, dass die Abfrage `games` nicht eingefügt hat.

Zugehörige Lektionen

  • Java · Lektion 43 · Fortgeschritten · Version: 2
  • Java · Lektion 56 · Grundlagen · Version: 2
  • Java · Lektion 39 · Mittlere Stufe · Version: 2

Quellen