???? および ?? 演算子 (C# リファレンス)and ??= operators (C# reference)

null 合体演算子 ?? では、それが null ではない場合、その左側のオペランドの値が返されます。それ以外の場合は、右側のオペランドが評価され、その結果が返されます。The null-coalescing operator ?? returns the value of its left-hand operand if it isn't null; otherwise, it evaluates the right-hand operand and returns its result. ?? 演算子では、左側のオペランドが null 値以外に評価された場合は、その右側のオペランドは評価されません。The ?? operator doesn't evaluate its right-hand operand if the left-hand operand evaluates to non-null.

C# 8.0 以降では、左側のオペランドが null に評価された場合にのみ、右側のオペランドの値を左側のオペランドに割り当てる null 合体割り当て演算子 ??= を使用できます。Available in C# 8.0 and later, the null-coalescing assignment operator ??= assigns the value of its right-hand operand to its left-hand operand only if the left-hand operand evaluates to null. ??= 演算子では、左側のオペランドが null 値以外に評価された場合は、その右側のオペランドは評価されません。The ??= operator doesn't evaluate its right-hand operand if the left-hand operand evaluates to non-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

??= 演算子の左側のオペランドは、変数、プロパティ、またはインデクサー要素である必要があります。The left-hand operand of the ??= operator must be a variable, a property, or an indexer element.

C# 7.3 以前では、?? 演算子の左側のオペランドの型は、参照型または null 許容値型である必要があります。In C# 7.3 and earlier, the type of the left-hand operand of the ?? operator must be either a reference type or a nullable value type. C# 8.0 以降では、その要件は次に置き換えられます。?? 演算子と ??= 演算子の左側のオペランドの型は、null 非許容値型にすることはできません。Beginning with C# 8.0, that requirement is replaced with the following: the type of the left-hand operand of the ?? and ??= operators cannot be a non-nullable value type. 特に、C# 8.0 以降では、null 合体演算子を制約のない型パラメーターと共に使用できます。In particular, beginning with C# 8.0, you can use the null-coalescing operators with unconstrained type parameters:

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

null 合体演算子は、右結合です。The null-coalescing operators are right-associative. つまり、フォームの式That is, expressions of the form

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

は次のように評価されます。are evaluated as

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

Examples

?? 演算子および ??= 演算子は、次のシナリオで役立つことがあります。The ?? and ??= operators can be useful in the following scenarios:

  • null 条件演算子 ?. および ?[] を含む式は、null 条件演算の式の結果が null の場合に評価する代替の式を指定するために、?? 演算子を使用することができます。In expressions with the null-conditional operators ?. and ?[], you can use the ?? operator to provide an alternative expression to evaluate in case the result of the expression with null-conditional operations is 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 の場合に提供する値を指定します。When you work with nullable value types and need to provide a value of an underlying value type, use the ?? operator to specify the value to provide in case a nullable type value is null:

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

    null 値許容型が null の場合に使用される値を、基になる値型の既定値にする場合は、Nullable<T>.GetValueOrDefault() メソッドを使用します。Use the Nullable<T>.GetValueOrDefault() method if the value to be used when a nullable type value is null should be the default value of the underlying value type.

  • C# 7.0 以降では、?? 演算子の右側のオペランドとして throwを使用し、引数のチェック コードをより簡潔にすることができます。Beginning with C# 7.0, you can use a throw expression as the right-hand operand of the ?? operator to make the argument-checking code more concise:

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

    上記の例は、式のようなメンバーを使用してプロパティを定義する方法も示しています。The preceding example also demonstrates how to use expression-bodied members to define a property.

  • C# 8.0 以降では、??= 演算子を使用して、フォームのコードBeginning with C# 8.0, you can use the ??= operator to replace the code of the form

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

    を、以下のコードに置き換えます。with the following code:

    variable ??= expression;
    

演算子のオーバーロード可/不可Operator overloadability

演算子 ?? および ??= はオーバーロードできません。The operators ?? and ??= cannot be overloaded.

C# 言語仕様C# language specification

?? 演算子の詳細については、C# 言語仕様null 合体演算子に関するセクションを参照してください。For more information about the ?? operator, see The null coalescing operator section of the C# language specification.

??= リテラルの詳細については、機能提案メモを参照してください。For more information about the ??= operator, see the feature proposal note.

参照See also