?? e operatori ??= - gli operatori di coalescenza di valori Null
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 sianull
: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 sianull
: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 moduloif (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à.