?? и ??= (справочник по C#)

Оператор объединения с NULL ?? возвращает значение своего операнда слева, если его значение не равно null. В противном случае он вычисляет операнд справа и возвращает его результат. Оператор ?? не выполняет оценку своего операнда справа, если его операнд слева имеет значение, отличное от NULL.

Начиная с C# 8.0 можно использовать оператор присваивания объединения со значением NULL ??= для присваивания значения правого операнда левому операнду только в том случае, если левый операнд принимает значение null. Оператор ??= не выполняет оценку своего операнда справа, если его операнд слева имеет значение, отличное от NULL.

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

(numbers ??= new List<int>()).Add(5);
Console.WriteLine(string.Join(" ", numbers));  // output: 5

numbers.Add(a ??= 0);
Console.WriteLine(string.Join(" ", numbers));  // output: 5 0
Console.WriteLine(a);  // output: 0

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

В C# 7.3 и более ранних версий левый операнд оператора ?? должен иметь либо ссылочный тип, либо тип значения, допускающий значение NULL. Начиная с C# 8.0 это требование заменяется следующим: тип левого операнда операторов ?? и ??= не может быть типом значения, не допускающим значение NULL. В частности, начиная с версии C# 8.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, чтобы задать альтернативное выражение для оценки на случай, если результат выражения с 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, должно быть значением по умолчанию базового типа.

  • Начиная с версии C# 7.0, можно сократить код проверки аргументов, используя выражение throw в качестве правого операнда оператора ??:

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

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

  • Начиная с версии C# 8.0, можно использовать оператор ??= для замены кода формы

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

    на новый код:

    variable ??= expression;
    

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

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

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

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

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

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