Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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