?? e operatori ??= - gli operatori di coalescenza di valori Null

  • Articolo

L'operatore null-coalescing ?? restituisce il valore dell'operando a sinistra se è null; in caso contrario, valuta l'operando a destra e ne restituisce il risultato. L'operatore ?? non valuta l'operando di destra se l'operando di sinistra restituisce un valore non Null. L'operatore di assegnazione per coalescenza di valori Null ??= 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 non 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 valore che non ammette i valori Null. In particolare, è possibile usare gli operatori di coalescenza di valori Null con parametri di tipo non vincolato:

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

Gli operatori di coalescenza di valori Null sono associati a destra. Ovvero, le espressioni del modulo

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

vengono valutate come

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

Esempi

Gli operatori ?? e ??= possono essere utili negli scenari seguenti:

  • Nelle espressioni con gli operatori condizionali null ?. e ?[], è possibile usare l'operatore ?? per creare un'espressione alternativa da valutare nel caso in cui il risultato dell'operazione con operazioni 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

  • Se si usano tipi di valori nullable e si deve specificare un tipo valore sottostante, usare l'operatore?? per specificare il valore da fornire nel caso in cui un valore tipo nullable sia null:

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

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

  • È possibile usare un'espressione throw 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");
}

    L'esempio precedente dimostra anche 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;

Overload degli operatori

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

Specifiche del linguaggio C#

Per altre informazioni, sull’operatore ?? vedere la sezione L’operatore di coalescenza di valori Null nella Specifica del linguaggio C#.

Per altre informazioni sull’operatore ??=, vedere la nota relativa alla proposta di funzionalità.

Vedi anche