CKTIS / C#
GetValueOrDefault für IReadOnlyDictionary
Lies einen Wörterbuchwert mit Ersatzwert und erkenne, wann ein fehlender Schlüssel von gespeichertem `null` unterschieden werden muss.
Version: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
using System.Collections.Generic;
// Extension signatures on System.Collections.Generic.CollectionExtensions:
public static TValue? GetValueOrDefault<TKey, TValue>(this IReadOnlyDictionary<TKey, TValue> dictionary, TKey key);
public static TValue GetValueOrDefault<TKey, TValue>(this IReadOnlyDictionary<TKey, TValue> dictionary, TKey key, TValue defaultValue);
// Extension call and equivalent static call:
dictionary.GetValueOrDefault(key);
CollectionExtensions.GetValueOrDefault(dictionary, key);
dictionary.GetValueOrDefault(key, defaultValue);
CollectionExtensions.GetValueOrDefault(dictionary, key, defaultValue);In C# 12 und .NET 8 ruft dictionary.GetValueOrDefault(key) eine Erweiterungsmethode von CollectionExtensions im Namespace System.Collections.Generic auf, keine Instanzmethode von IReadOnlyDictionary<TKey, TValue>. using System.Collections.Generic; macht die Erweiterung verfügbar. Der gleichwertige statische Aufruf CollectionExtensions.GetValueOrDefault(dictionary, key) macht ihre Herkunft sichtbar. Dictionary<TKey, TValue> implementiert die schreibgeschützte Schnittstelle; eine nur als IDictionary<TKey, TValue> deklarierte Variable stellt diese Erweiterung nicht bereit. Schreibgeschützter Zugriff macht die zugrunde liegende Sammlung nicht unveränderlich.
Beide Überladungen geben bei vorhandenem Schlüssel den gespeicherten Wert zurück, auch null. Fehlt der Schlüssel, liefert die Überladung ohne Ersatzwert default(TValue) (etwa null für einen Referenztyp oder 0 für int), die andere das übergebene defaultValue. Der Argumentausdruck wird auch bei einem Treffer vor dem Aufruf ausgewertet. Dagegen setzt dictionary.GetValueOrDefault(key) ?? fallback voraus, dass sich das Ergebnis der Abfrage als linker Operand von ?? verwenden lässt, wie bei Cmd? im Beispiel. Dann wird fallback nur ausgewertet und verwendet, wenn die Abfrage null liefert, also auch bei gespeichertem null. Für TValue = int lässt sich dieser Ausdruck nicht kompilieren, da die Abfrage einen int liefert, der nicht null sein kann.
Um einen fehlenden Schlüssel von einem gespeicherten Wert zu unterscheiden, der dem Standard- oder Ersatzwert entspricht, verwende TryGetValue(key, out var value) und prüfe den zurückgegebenen bool. Ein fehlender Schlüssel löst in GetValueOrDefault keine Ausnahme aus; ArgumentNullException wird ausgelöst, wenn die Wörterbuchreferenz selbst null ist. Dictionary<TKey, TValue> lehnt auch einen Schlüssel mit dem Wert null mit derselben Ausnahme ab.
Mit #nullable enable darf eine Cmd?-Referenz null sein. Das ist eine Annotation für die Compileranalyse, keine Hülle und keine Laufzeitprüfung. Die Wörterbucherweiterung ist nicht die Instanzmethode Nullable<T>.GetValueOrDefault() für nullable Werttypen.
In einer Mini-DSL prüft der Parser den Text anhand der Grammatik und baut einen abstrakten Syntaxbaum (AST) auf. Der Evaluator interpretiert nur unterstützte Knoten und löst Befehlsnamen über ein Register auf. Übergib den Text nicht an JavaScripts eval. Ist ein unbekannter Befehl ein Fehler, melde ihn mithilfe von TryGetValue, statt stillschweigend einen Ersatzbefehl zu wählen.
Beispiele
#nullable enable
using System;
using System.Collections.Generic;
IReadOnlyDictionary<string, Cmd?> commands = new Dictionary<string, Cmd?>(StringComparer.Ordinal)
{
["print"] = new Cmd("PRINT"),
["disabled"] = null
};
var fallback = new Cmd("FALLBACK");
Console.WriteLine($"hit: {Show(commands.GetValueOrDefault("print"))}");
Console.WriteLine($"missing: {Show(commands.GetValueOrDefault("missing"))}");
Console.WriteLine($"missing with fallback: {Show(commands.GetValueOrDefault("missing", fallback))}");
Console.WriteLine($"stored null with fallback: {Show(commands.GetValueOrDefault("disabled", fallback))}");
Console.WriteLine($"static: {Show(CollectionExtensions.GetValueOrDefault(commands, "missing", fallback))}");
Console.WriteLine($"presence of missing: {commands.TryGetValue("missing", out _)}");
Console.WriteLine($"presence of disabled: {commands.TryGetValue("disabled", out _)}");
static string Show(Cmd? cmd) => cmd?.Name ?? "<null>";
sealed record Cmd(string Name);
Ergebnis
hit: PRINT missing: <null> missing with fallback: FALLBACK stored null with fallback: <null> static: FALLBACK presence of missing: False presence of disabled: True
`missing` fehlt, für `disabled` ist `null` gespeichert. Nur der fehlende Schlüssel liefert `FALLBACK`; die beiden `TryGetValue`-Aufrufe zeigen, welcher Schlüssel vorhanden ist.
Zugehörige Lektionen
- C# · Lektion 57 · Fortgeschritten · Version: 3
Quellen
- CollectionExtensions.GetValueOrDefault Method
- IReadOnlyDictionary<TKey,TValue> Interface
- IReadOnlyDictionary<TKey,TValue>.TryGetValue(TKey, TValue) Method
- Dictionary<TKey,TValue>.TryGetValue(TKey, TValue) Method
- How to implement and call a custom extension method
- Nullable reference types
- ?? and ??= operators - the null-coalescing operators
- Get started with syntax analysis (Roslyn APIs)
- C# language versioning
- dotnet new <TEMPLATE>