?? И?? = операторы — операторы объединения null

Оператор объединения с NULL ?? возвращает значение своего операнда слева, если его значение не равно null. В противном случае он вычисляет операнд справа и возвращает его результат. Оператор ?? не вычисляет правый операнд, если значение левого операнда отлично от NULL. Оператор ??= присваивания присваивания null-объединения присваивает значение правого операнда левой операнда только в том случае, если левый операнд оценивается null. Оператор ??= не вычисляет правый операнд, если значение левого операнда отлично от 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	        

Левый операнд оператора ??= должен быть переменной, свойством или элементом индексатора.

Тип левого ?? операнда и ??= операторов не может быть типом ненулевого значения. В частности, можно использовать операторы объединения null с параметрами неограниченного типа:

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

Операторы объединения со значением NULL являются правоассоциативными. То есть выражения в форме

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

вычисляются как

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

Примеры

Операторы ?? и ??= могут быть полезны в таких случаях:

  • В выражениях с операторами?., допускающих значение NULL, можно?[] использовать ?? оператор для предоставления альтернативного выражения для оценки в случае, если результат выражения с помощью условно-пустых операций:null

    double SumNumbers(List<double[]> setsOfNumbers, int indexOfSetToSum)
    {
        return setsOfNumbers?[indexOfSetToSum]?.Sum() ?? double.NaN;
    }
    
    var sum = SumNumbers(null, 0);
    Console.WriteLine(sum);  // output: NaN
    
  • Когда вы работаете с типами, допускающими значение NULL, и вам нужно указать значение базового типа значения, используйте оператор ?? для указания значения, возвращаемого в том случае, если значение типа, допускающего значение NULL, равно null.

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

    Используйте метод Nullable<T>.GetValueOrDefault(), если значение, которое будет использоваться, когда значение типа, допускающего значение NULL, равно null, должно быть значением по умолчанию базового типа.

  • Выражение можно использовать throw в качестве правого операнда ?? оператора, чтобы сделать аргумент-проверка код более кратким:

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

    В предыдущем примере также демонстрируются способы определения свойства с помощью членов, заданных выражениями.

  • Оператор можно использовать ??= для замены кода формы.

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

    указанным ниже кодом:

    variable ??= expression;
    

Возможность перегрузки оператора

Операторы ?? и ??= не могут быть перегружены.

Спецификация языка C#

Дополнительные сведения об операторе ?? см. в разделе об операторе объединения со значением NULL в спецификации языка C#.

См. сведения об операторе ??= в примечании к предлагаемой функции.

См. также