Megosztás:


?? és ??= operátorok – a null-szenesítő operátorok

A null-szenesítő operátor ?? a bal oldali operandus értékét adja vissza, ha nem null. Ellenkező esetben kiértékeli a jobb oldali operandust, és visszaadja annak eredményét. A ?? operátor nem értékeli a jobb oldali operandusát, ha a bal oldali operandus értéke nem null. A null-szenesítési hozzárendelés operátora ??= csak akkor rendeli hozzá a jobb oldali operandus értékét a bal oldali operandushoz, ha a bal operandus kiértékeli a következőt null: . A ??= operátor nem értékeli a jobb oldali operandusát, ha a bal oldali operandus értéke nem 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

Az operátor bal oldali operandusának ??= változónak, tulajdonságnak vagy indexelőelemnek kell lennie.

A C# nyelv referenciadokumentuma a C# nyelv legújabb kiadású verzióját ismerteti. Emellett a közelgő nyelvi kiadás nyilvános előzetes verziójú funkcióinak kezdeti dokumentációját is tartalmazza.

A dokumentáció azonosítja azokat a funkciókat, amelyeket először a nyelv utolsó három verziójában vagy az aktuális nyilvános előzetes verziókban vezetnek be.

Jótanács

Ha meg szeretné tudni, hogy mikor jelent meg először egy funkció a C#-ban, tekintse meg a C# nyelvi verzióelőzményeiről szóló cikket.

A ?? és ??= operátorok bal oldali operandusának típusa nem lehet nem-nullítható értéktípus. Különösen akkor használhatja a null-egyesítő operátorokat, ha a típusparaméterek nincsenek korlátozva.

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

A null-egyesítő operátorok jobban asszociatívak. Vagyis a forma kifejezései

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

kiértékelése a következőként történik:

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

Példák

Az ?? operátorok a ??= következő helyzetekben hasznosak:

  • A null feltételes operátorokat ?.?[]használó kifejezésekben az operátorral ?? adjon meg egy alternatív kifejezést annak kiértékeléséhez, hogy a null-feltételes művelettel rendelkező kifejezés eredménye a következő null:

    double SumNumbers(List<double[]> setsOfNumbers, int indexOfSetToSum)
    {
        return setsOfNumbers?[indexOfSetToSum]?.Sum() ?? double.NaN;
    }
    
    var sum = SumNumbers(null, 0);
    Console.WriteLine(sum);  // output: NaN
    
  • Ha null értékű értéktípusokkal dolgozik, és egy mögöttes értéktípus értékét kell megadnia, az ?? operátorral adja meg a megadható értéket, ha a null értékű érték a következő null:

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

    Akkor használja a Nullable<T>.GetValueOrDefault() metódust, ha a null értékű típus értéke null az alapul szolgáló érték alapértelmezett értéke.

  • Ha tömörebbé szeretné tenni az argumentum-ellenőrző kódot, használjon egythrow kifejezést az operátor jobb oldali operandusaként??:

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

    Az előző példa azt is bemutatja, hogyan definiálhat egy tulajdonságot kifejezésre alkalmas tagok használatával.

  • Az operátorral ??= cserélje le a következő űrlap kódját:

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

    Használja a következő kódot:

    variable ??= expression;
    

Operátorok túlterhelése

Nem lehet túlterhelni az operátorokat és ??= az ?? operátorokat.

C# nyelvspecifikáció

Az ?? operátorral kapcsolatos további információkért lásd a C# nyelvi specifikáció null összefésülő operátor szakaszát.

Az operátorral kapcsolatos ??= további információkért tekintse meg a C# nyelvspecifikáció összetett hozzárendelési szakaszát.

Lásd még