?? И?? = операторы — операторы объединения со значением 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. В частности, можно использовать операторы объединения со значением 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 равен 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#.

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

См. также раздел