Condividi tramite

?? e operatori ??= - gli operatori di null-coalescing

L'operatore null-coalescing ?? restituisce il valore dell'operando di sinistra se questo non è null; in caso contrario, valuta l'operando di destra e ne restituisce il risultato. L'operatore ?? non valuta l'operando di destra se l'operando di sinistra restituisce un valore diverso da Null. L'operatore ??= di assegnazione null-coalescing assegna il valore dell'operando di destra al relativo operando di sinistra solo se l'operando di sinistra restituisce null. L'operatore ??= non valuta l'operando di destra se l'operando di sinistra restituisce un valore diverso da Null.

List<int>? numbers = null;
int? a = null;

Console.WriteLine((numbers is null)); // expected: true
// if numbers is null, initialize it. Then, add 5 to numbers
(numbers ??= new List<int>()).Add(5);
Console.WriteLine(string.Join(" ", numbers));  // output: 5
Console.WriteLine((numbers is null)); // expected: false        


Console.WriteLine((a is null)); // expected: true
Console.WriteLine((a ?? 3)); // expected: 3 since a is still null 
// if a is null then assign 0 to a and add a to the list
numbers.Add(a ??= 0);
Console.WriteLine((a is null)); // expected: false        
Console.WriteLine(string.Join(" ", numbers));  // output: 5 0
Console.WriteLine(a);  // output: 0

L'operando sinistro dell'operatore ??= deve essere una variabile, una proprietà o un elemento dell'indicizzatore .

Il tipo dell'operando sinistro degli operatori ?? e ??= non può essere un tipo di valore non annullabile. In particolare, è possibile usare gli operatori null-coalescing con parametri di tipo non vincolato:

private static void Display<T>(T a, T backup)
{
    Console.WriteLine(a ?? backup);
}

Gli operatori null-coalescing sono destro-associativi. Cioè, espressioni della forma

a ?? b ?? c
d ??= e ??= f

vengono valutati come

a ?? (b ?? c)
d ??= (e ??= f)

Esempi

?? e ??= operatori possono essere utili nei seguenti scenari:

  • Nelle espressioni con gli operatori condizionali null ?. e ?[], è possibile usare l'operatore ?? per fornire un'espressione alternativa da valutare nel caso in cui il risultato dell'espressione con operatori condizionali null sia null:

    double SumNumbers(List<double[]> setsOfNumbers, int indexOfSetToSum)
{
    return setsOfNumbers?[indexOfSetToSum]?.Sum() ?? double.NaN;
}

var sum = SumNumbers(null, 0);
Console.WriteLine(sum);  // output: NaN

  • Quando si usano tipi valore nullable ed è necessario specificare un valore di un tipo valore sottostante, usare l'operatore ?? per specificare il valore da specificare nel caso in cui un valore di tipo nullable sia null:

    int? a = null;
int b = a ?? -1;
Console.WriteLine(b);  // output: -1

    Utilizzare il metodo Nullable<T>.GetValueOrDefault() se il valore da utilizzare quando un valore di tipo nullable è null deve essere il valore predefinito del tipo di valore sottostante.

  • È possibile usare un'espressionethrow come operando di destra dell'operatore ?? per rendere il codice di controllo degli argomenti più conciso:

    public string Name
{
    get => name;
    set => name = value ?? throw new ArgumentNullException(nameof(value), "Name cannot be null");
}

    Nell'esempio precedente viene inoltre illustrato come usare membri con corpo di espressione per definire una proprietà.

  • È possibile utilizzare l'operatore ??= per sostituire il codice del modulo

    if (variable is null)
{
    variable = expression;
}

    con il seguente codice:

    variable ??= expression;

Sovraccarico degli operatori

Gli operatori ?? e ??= non possono essere sovraccaricati.

Specifiche del linguaggio C#

Per altre informazioni sull'operatore ?? , vedere la sezione Operatore di unione Null della specifica del linguaggio C#.

Per altre informazioni sull'operatore ??= , vedere la nota sulla proposta di funzionalità.

Vedere anche