CKTIS / C#
GetValueOrDefault dla IReadOnlyDictionary
Pobierz wartość ze słownika z wartością zastępczą i rozpoznaj, kiedy trzeba odróżnić brak klucza od zapisanego `null`.
Wersja: C# 12 and .NET 8; later runtimes may add compatible features
Składnia
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);W C# 12 i .NET 8 wywołanie dictionary.GetValueOrDefault(key) korzysta z metody rozszerzającej CollectionExtensions z przestrzeni nazw System.Collections.Generic, a nie z metody instancyjnej IReadOnlyDictionary<TKey, TValue>. Dyrektywa using System.Collections.Generic; udostępnia składnię rozszerzenia; równoważne wywołanie statyczne CollectionExtensions.GetValueOrDefault(dictionary, key) pokazuje pochodzenie metody. Dictionary<TKey, TValue> implementuje ten interfejs, ale zmienna zadeklarowana wyłącznie jako IDictionary<TKey, TValue> nie udostępnia tego rozszerzenia. Interfejs tylko do odczytu nie gwarantuje niezmienności kolekcji.
Oba przeciążenia zwracają zapisaną wartość, jeśli klucz istnieje, nawet gdy to null. Gdy klucza brakuje, wersja bez wartości zastępczej zwraca default(TValue) (np. null dla typu referencyjnego lub 0 dla int), a wersja z argumentem defaultValue zwraca właśnie ten argument. Wyrażenie przekazane jako argument jest obliczane przed wywołaniem, nawet przy trafieniu. Zapis dictionary.GetValueOrDefault(key) ?? fallback wymaga, aby wynik wyszukiwania mógł być lewym operandem ??, tak jak Cmd? w przykładzie. Wtedy fallback jest obliczane tylko wtedy, gdy wynik po lewej stronie to null, również gdy null jest zapisaną wartością. Dla TValue = int ten zapis się nie kompiluje, ponieważ metoda zwraca int, który nie dopuszcza null.
Jeśli trzeba rozróżnić brak klucza od zapisanej wartości równej domyślnej lub zastępczej, użyj TryGetValue(key, out var value) i sprawdź zwrócone bool. Brak klucza nie powoduje wyjątku w GetValueOrDefault, ale przekazanie słownika o wartości null powoduje ArgumentNullException. Dictionary<TKey, TValue> odrzuca także klucz null tym samym wyjątkiem.
W #nullable enable zapis Cmd? oznacza referencję do Cmd, która może być null. To adnotacja dla analizy kompilatora, nie opakowanie ani kontrola w czasie wykonywania. Nie myl rozszerzenia dla słownika z osobną metodą Nullable<T>.GetValueOrDefault() dla typów wartościowych dopuszczających null.
W architekturze mini-DSL parser sprawdza składnię tekstu według gramatyki i buduje abstrakcyjne drzewo składni (AST). Ewaluator interpretuje tylko obsługiwane węzły i rozpoznaje polecenia przez rejestr. Nie przekazuj tekstu do JavaScriptowego eval. Jeśli nieznane polecenie jest błędem, zgłoś je po TryGetValue, zamiast po cichu wybierać polecenie zastępcze.
Przykłady
#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);
Wynik
hit: PRINT missing: <null> missing with fallback: FALLBACK stored null with fallback: <null> static: FALLBACK presence of missing: False presence of disabled: True
`missing` nie występuje w słowniku, a `disabled` jest zapisane jako `null`. Wartość `FALLBACK` zastępuje tylko brak klucza; oba wywołania `TryGetValue` pokazują różnicę w obecności klucza.
Powiązane lekcje
- C# · Lekcja 57 · Zaawansowany · Wersja: 3
Źródła
- 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>