CKTIS / C#
GetValueOrDefault za IReadOnlyDictionary
Preberi vrednost iz slovarja z nadomestno vrednostjo in po potrebi loči manjkajoči ključ od shranjene vrednosti `null`.
Različica: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
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 in .NET 8 klic dictionary.GetValueOrDefault(key) uporabi razširitveno metodo razreda CollectionExtensions v imenskem prostoru System.Collections.Generic, ne primerkovne metode vmesnika IReadOnlyDictionary<TKey, TValue>. Razširitev uvoziš z using System.Collections.Generic;, njen izvor pa pokaže enakovreden statični klic CollectionExtensions.GetValueOrDefault(dictionary, key). Dictionary<TKey, TValue> implementira vmesnik samo za branje, toda spremenljivka, deklarirana samo kot IDictionary<TKey, TValue>, te razširitve ne ponuja. Dostop samo za branje ne zagotavlja nespremenljivosti osnovne zbirke.
Obe preobremenitvi vrneta shranjeno vrednost, če ključ obstaja, tudi če je vrednost null. Če ključa ni, različica brez nadomestne vrednosti vrne default(TValue) (na primer null za referenčni tip ali 0 za int); druga vrne podani defaultValue. Izraz argumenta se ovrednoti pred klicem, tudi če ključ obstaja. Pri zapisu dictionary.GetValueOrDefault(key) ?? fallback mora biti rezultat iskanja primeren za levi operand operatorja ??, kot je Cmd? v primeru. Tedaj se fallback ovrednoti in uporabi le, če iskanje vrne null, tudi kadar je null shranjena vrednost. Pri TValue = int se izraz ne prevede, ker iskanje vrne int, ki ne more biti null.
Za razlikovanje med manjkajočim ključem in shranjeno vrednostjo, ki je enaka privzeti ali nadomestni, uporabi TryGetValue(key, out var value) in preveri vrnjeni bool. Manjkajoči ključ v GetValueOrDefault ne sproži izjeme, če pa je sama referenca na slovar null, metoda sproži ArgumentNullException. Dictionary<TKey, TValue> z isto izjemo zavrne tudi ključ null.
Pri #nullable enable zapis Cmd? pomeni, da je referenca na Cmd lahko null. To je oznaka za analizo prevajalnika, ne ovoj ali preverjanje med izvajanjem. Razširitev za slovar se razlikuje od primerkovne metode Nullable<T>.GetValueOrDefault() za vrednostne tipe, ki dopuščajo null.
V mini DSL razčlenjevalnik preveri besedilo po slovnici in zgradi abstraktno sintaktično drevo (AST). Evalvator interpretira le podprta vozlišča in poišče imena ukazov v registru. Besedila ne podajaj funkciji eval v JavaScriptu. Če je neznani ukaz napaka, jo sporoči s pomočjo TryGetValue, namesto da tiho izbereš nadomestni ukaz.
Primeri
#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);
Rezultat
hit: PRINT missing: <null> missing with fallback: FALLBACK stored null with fallback: <null> static: FALLBACK presence of missing: False presence of disabled: True
`missing` manjka, za `disabled` pa je shranjen `null`. Samo manjkajoči ključ vrne `FALLBACK`; oba klica `TryGetValue` pokažeta, kateri ključ obstaja.
Povezane lekcije
- C# · Lekcija 57 · Napredna · Različica: 3
Viri
- 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>