Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

GetValueOrDefault za IReadOnlyDictionary

Dohvati vrijednost iz rječnika uz zamjensku vrijednost i po potrebi razlikuj ključ koji nedostaje od pohranjenog `null`.

Verzija: 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);

U C# 12 i .NET 8 poziv dictionary.GetValueOrDefault(key) koristi metodu proširenja klase CollectionExtensions u imenskom prostoru System.Collections.Generic, a ne metodu instance sučelja IReadOnlyDictionary<TKey, TValue>. Proširenje je dostupno uz using System.Collections.Generic;, a njegovo podrijetlo možeš istaknuti jednakovrijednim statičkim pozivom CollectionExtensions.GetValueOrDefault(dictionary, key). Dictionary<TKey, TValue> implementira sučelje samo za čitanje, ali varijabla deklarirana samo kao IDictionary<TKey, TValue> ne nudi to proširenje. Pristup samo za čitanje ne jamči nepromjenjivost temeljne kolekcije.

Obje preopterećene inačice vraćaju pohranjenu vrijednost ako ključ postoji, čak i ako je ona null. Ako ključ nedostaje, inačica bez zamjenske vrijednosti vraća default(TValue) (primjerice null za referentni tip ili 0 za int); druga vraća zadani argument defaultValue. Izraz argumenta izračunava se prije poziva, čak i ako ključ postoji. Nasuprot tome, dictionary.GetValueOrDefault(key) ?? fallback zahtijeva da rezultat pretraživanja može biti lijevi operand operatora ??, kao što je Cmd? u primjeru. Tada se fallback izračunava i koristi samo ako pretraživanje vrati null, pa i kada je null pohranjena vrijednost. Za TValue = int izraz se ne može prevesti jer pretraživanje vraća int, koji ne može biti null.

Za razlikovanje ključa koji nedostaje od pohranjene vrijednosti jednake zadanoj ili zamjenskoj upotrijebi TryGetValue(key, out var value) i provjeri vraćeni bool. Nedostajući ključ ne izaziva iznimku u GetValueOrDefault, ali rječnik čija je referenca null izaziva ArgumentNullException. Dictionary<TKey, TValue> istom iznimkom odbija i ključ null.

Uz #nullable enable, Cmd? znači da referenca na Cmd može biti null. To je oznaka za analizu prevoditelja, a ne omotač ili provjera tijekom izvođenja. Proširenje za rječnike razlikuje se od metode instance Nullable<T>.GetValueOrDefault() za vrijednosne tipove koji dopuštaju null.

U mini DSL-u parser provjerava tekst prema gramatici i gradi apstraktno sintaksno stablo (AST). Evaluator tumači samo podržane čvorove i traži nazive naredbi u registru. Ne prosljeđuj tekst JavaScriptovoj funkciji eval. Ako je nepoznata naredba pogreška, prijavi je uz pomoć TryGetValue umjesto da bez upozorenja izabereš zamjensku naredbu.

Primjeri

#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` nedostaje, a za `disabled` je pohranjen `null`. Samo ključ koji nedostaje dobiva `FALLBACK`; dva poziva `TryGetValue` pokazuju koji ključ postoji.

Povezane lekcije

  • C# · Lekcija 57 · Napredno · Verzija: 3

Izvori