CKTIS / C#
GetValueOrDefault pre IReadOnlyDictionary
Získaj hodnotu zo slovníka s náhradnou hodnotou a v prípade potreby rozlíš chýbajúci kľúč od uloženého `null`.
Verzia: 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);V C# 12 a .NET 8 volá dictionary.GetValueOrDefault(key) rozširujúcu metódu triedy CollectionExtensions z menného priestoru System.Collections.Generic, nie inštančnú metódu rozhrania IReadOnlyDictionary<TKey, TValue>. Rozšírenie sprístupní using System.Collections.Generic;, jeho pôvod ukáže rovnocenné statické volanie CollectionExtensions.GetValueOrDefault(dictionary, key). Dictionary<TKey, TValue> implementuje rozhranie iba na čítanie, ale premenná deklarovaná iba ako IDictionary<TKey, TValue> toto rozšírenie nesprístupňuje. Prístup iba na čítanie nezaručuje nemennosť podkladovej kolekcie.
Obe preťaženia vrátia uloženú hodnotu, ak kľúč existuje, aj keď je to null. Ak kľúč chýba, verzia bez náhradnej hodnoty vráti default(TValue) (napríklad null pre referenčný typ alebo 0 pre int); druhá vráti zadané defaultValue. Výraz zadaný ako argument sa vyhodnotí pred volaním, aj keď kľúč existuje. Zápis dictionary.GetValueOrDefault(key) ?? fallback vyžaduje, aby výsledok vyhľadávania mohol byť ľavým operandom ??, ako je to pri Cmd? v príklade. Vtedy sa fallback vyhodnotí a použije len vtedy, keď vyhľadávanie vráti null, teda aj pri uloženej hodnote null. Pre TValue = int sa tento výraz neskompiluje, pretože vyhľadávanie vracia int, ktorý nemôže byť null.
Ak chceš odlíšiť chýbajúci kľúč od uloženej hodnoty rovnajúcej sa predvolenej alebo náhradnej hodnote, použi TryGetValue(key, out var value) a skontroluj vrátený bool. Chýbajúci kľúč v GetValueOrDefault nespôsobí výnimku, ale ak je samotná referencia na slovník null, metóda vyvolá ArgumentNullException. Dictionary<TKey, TValue> tou istou výnimkou odmietne aj kľúč null.
Pri #nullable enable znamená Cmd?, že referencia na Cmd môže byť null. Je to anotácia pre analýzu kompilátora, nie obal ani kontrola počas behu. Rozšírenie pre slovník sa líši od inštančnej metódy Nullable<T>.GetValueOrDefault() pre hodnotové typy pripúšťajúce null.
V mini-DSL syntaktický analyzátor overuje text podľa gramatiky a vytvára abstraktný syntaktický strom (AST). Vyhodnocovač interpretuje len podporované uzly a vyhľadáva názvy príkazov v registri. Neposielaj text do eval v JavaScripte. Ak je neznámy príkaz chybou, ohlás ju pomocou TryGetValue namiesto tichého výberu náhradného príkazu.
Prí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ýsledok
hit: PRINT missing: <null> missing with fallback: FALLBACK stored null with fallback: <null> static: FALLBACK presence of missing: False presence of disabled: True
`missing` chýba, kým pri `disabled` je uložené `null`. Len chýbajúci kľúč dostane `FALLBACK`; obe volania `TryGetValue` ukazujú, ktorý kľúč existuje.
Súvisiace lekcie
- C# · Lekcia 57 · Pokročilá · Verzia: 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>