База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

GetValueOrDefault за IReadOnlyDictionary

Извлечи стойност от речник с резервна стойност и при нужда различи липсващ ключ от записана стойност `null`.

Версия: C# 12 and .NET 8; later runtimes may add compatible features

Синтаксис

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

В C# 12 и .NET 8 dictionary.GetValueOrDefault(key) извиква метод за разширение на CollectionExtensions от пространството от имена System.Collections.Generic, а не метод на екземпляр на IReadOnlyDictionary<TKey, TValue>. Директивата using System.Collections.Generic; осигурява достъп до разширението, а равностойното статично извикване CollectionExtensions.GetValueOrDefault(dictionary, key) показва откъде идва методът. Dictionary<TKey, TValue> реализира интерфейса само за четене, но променлива, декларирана само като IDictionary<TKey, TValue>, не предоставя това разширение. Достъпът само за четене не гарантира, че самата колекция е неизменяема.

И двата варианта връщат записаната стойност, ако ключът съществува, дори тя да е null. Ако ключът липсва, вариантът без резервна стойност връща default(TValue) (например null за референтен тип или 0 за int), а другият връща подадената стойност defaultValue. Изразът за аргумента се изчислява преди извикването дори ако ключът съществува. За разлика от това dictionary.GetValueOrDefault(key) ?? fallback изисква резултатът от търсенето да може да бъде ляв операнд на ??, както е при Cmd? в примера. Тогава fallback се изчислява и използва само ако търсенето върне null, включително когато null е записаната стойност. При TValue = int този израз не се компилира, защото търсенето връща int, който не допуска null.

За да различиш липсващ ключ от записана стойност, равна на стойността по подразбиране или на резервната, използвай TryGetValue(key, out var value) и провери върнатата стойност от тип bool. Липсващ ключ не предизвиква изключение в GetValueOrDefault, но ако самата референция към речника е null, методът предизвиква ArgumentNullException. Dictionary<TKey, TValue> отхвърля и ключ null със същото изключение.

При #nullable enable означението Cmd? показва, че референция към Cmd може да е null. Това е анотация за анализа на компилатора, а не обвивка или проверка по време на изпълнение. Разширението за речници е различно от метода на екземпляр Nullable<T>.GetValueOrDefault() за стойностни типове, допускащи null.

В мини DSL синтактичният анализатор проверява текста според граматиката и изгражда абстрактно синтактично дърво (AST). Оценителят интерпретира само поддържаните възли и търси имената на командите в регистър. Не подавай текста на JavaScript функцията eval. Ако непозната команда е грешка, съобщи я с помощта на TryGetValue, вместо без предупреждение да избираш резервна команда.

Примери

#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);

Резултат

hit: PRINT
missing: <null>
missing with fallback: FALLBACK
stored null with fallback: <null>
static: FALLBACK
presence of missing: False
presence of disabled: True

`missing` липсва, а за `disabled` е записано `null`. Само липсващият ключ получава `FALLBACK`; двете извиквания на `TryGetValue` показват кой ключ съществува.

Свързани уроци

  • C# · Урок 57 · Напреднало · Версия: 3

Източници