CKTIS / C#
GetValueOrDefault pro IReadOnlyDictionary
Získej hodnotu ze slovníku s náhradní hodnotou a v případě potřeby rozliš chybějící klíč od uloženého `null`.
Verze: C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
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);V C# 12 a .NET 8 volá dictionary.GetValueOrDefault(key) rozšiřující metodu třídy CollectionExtensions ze jmenného prostoru System.Collections.Generic, nikoli instanční metodu rozhraní IReadOnlyDictionary<TKey, TValue>. Rozšíření zpřístupní using System.Collections.Generic;, jeho původ ukáže rovnocenné statické volání CollectionExtensions.GetValueOrDefault(dictionary, key). Dictionary<TKey, TValue> implementuje rozhraní jen pro čtení, ale proměnná deklarovaná pouze jako IDictionary<TKey, TValue> toto rozšíření nezpřístupňuje. Přístup jen pro čtení nezaručuje neměnnost podkladové kolekce.
Obě přetížení vracejí uloženou hodnotu, pokud klíč existuje, i když je to null. Pokud klíč chybí, varianta bez náhradní hodnoty vrátí default(TValue) (například null pro referenční typ nebo 0 pro int); druhá vrátí předanou hodnotu defaultValue. Výraz předaný jako argument se vyhodnotí před voláním, i když klíč existuje. Zápis dictionary.GetValueOrDefault(key) ?? fallback vyžaduje, aby výsledek vyhledávání mohl být levým operandem ??, jako je tomu u Cmd? v příkladu. Pak se fallback vyhodnotí a použije jen tehdy, když vyhledávání vrátí null, tedy i v případě uložené hodnoty null. Pro TValue = int se tento výraz nepřeloží, protože vyhledávání vrací int, který nemůže být null.
Chceš-li odlišit chybějící klíč od uložené hodnoty shodné s výchozí nebo náhradní hodnotou, použij TryGetValue(key, out var value) a zkontroluj vrácený bool. Chybějící klíč v GetValueOrDefault nevyvolá výjimku, ale pokud je samotná reference na slovník null, metoda vyvolá ArgumentNullException. Dictionary<TKey, TValue> stejnou výjimkou odmítá i klíč null.
Při #nullable enable znamená Cmd?, že reference na Cmd může být null. Jde o anotaci pro analýzu překladače, nikoli o obal ani kontrolu za běhu. Rozšíření pro slovník se liší od instanční metody Nullable<T>.GetValueOrDefault() pro hodnotové typy připouštějící null.
V mini-DSL parser ověří text podle gramatiky a vytvoří abstraktní syntaktický strom (AST). Vyhodnocovač interpretuje pouze podporované uzly a vyhledává názvy příkazů v registru. Nepředávej text funkci eval v JavaScriptu. Pokud je neznámý příkaz chybou, ohlas ji pomocí TryGetValue namísto tiché volby náhradního příkazu.
Příklady
#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);
Výsledek
hit: PRINT missing: <null> missing with fallback: FALLBACK stored null with fallback: <null> static: FALLBACK presence of missing: False presence of disabled: True
`missing` chybí, zatímco u `disabled` je uloženo `null`. Pouze chybějící klíč dostane `FALLBACK`; obě volání `TryGetValue` ukazují, který klíč existuje.
Související lekce
- C# · Lekce 57 · Pokročilá · Verze: 3
Zdroje
- 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>