Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

GetValueOrDefault sur IReadOnlyDictionary

Lis une valeur de dictionnaire avec une valeur de repli et distingue, si nécessaire, une clé absente d’une valeur `null` stockée.

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

Avec C# 12 et .NET 8, dictionary.GetValueOrDefault(key) appelle une méthode d’extension de CollectionExtensions dans l’espace de noms System.Collections.Generic, et non un membre d’instance de IReadOnlyDictionary<TKey, TValue>. Importe-la avec using System.Collections.Generic; ou indique son origine par l’appel statique équivalent CollectionExtensions.GetValueOrDefault(dictionary, key). Dictionary<TKey, TValue> implémente l’interface en lecture seule, mais une variable déclarée uniquement comme IDictionary<TKey, TValue> ne donne pas accès à cette extension. L’accès en lecture seule ne garantit pas l’immuabilité de la collection sous-jacente.

Les deux surcharges renvoient la valeur stockée si la clé existe, même si cette valeur est null. Si la clé manque, la surcharge sans valeur de repli renvoie default(TValue) (par exemple null pour un type référence ou 0 pour int) ; l’autre renvoie le defaultValue fourni. L’expression passée en argument est évaluée avant l’appel, même si la clé existe. En revanche, dictionary.GetValueOrDefault(key) ?? fallback exige que le résultat de la recherche puisse servir d’opérande gauche de ??, comme Cmd? dans l’exemple. Dans ce cas, fallback n’est évalué et utilisé que si la recherche renvoie null, y compris lorsque null est la valeur stockée. Avec TValue = int, cette expression ne compile pas : la recherche renvoie un int qui ne peut pas être null.

Pour distinguer une clé absente d’une valeur stockée égale à la valeur par défaut ou de repli, utilise TryGetValue(key, out var value) et examine le bool renvoyé. Une clé absente ne provoque pas d’exception dans GetValueOrDefault, mais un dictionnaire null provoque une ArgumentNullException. Dictionary<TKey, TValue> rejette aussi une clé null avec cette exception.

Avec #nullable enable, Cmd? indique qu’une référence à Cmd peut être null. C’est une annotation pour l’analyse du compilateur, pas un type enveloppe ni une vérification à l’exécution. Cette extension de dictionnaire est distincte de la méthode d’instance Nullable<T>.GetValueOrDefault() pour les types valeur nullables.

Dans un mini-DSL, le parseur vérifie le texte selon la grammaire et construit un arbre syntaxique abstrait (AST). L’évaluateur n’interprète que les nœuds pris en charge et résout les noms de commandes à l’aide d’un registre. Ne passe pas le texte à eval de JavaScript. Si une commande inconnue constitue une erreur, signale-la à l’aide de TryGetValue plutôt que de choisir silencieusement une commande de repli.

Exemples

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

Résultat

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

`missing` est absent, tandis que `disabled` contient `null`. Seule la clé absente donne `FALLBACK` ; les deux appels à `TryGetValue` montrent quelle clé existe.

Leçons associées

  • C# · Leçon 57 · Avancé · Version : 3

Sources