Sdílet prostřednictvím


is – operátor (referenční dokumentace jazyka C#)

Operátor is zkontroluje, jestli je výsledek výrazu kompatibilní s daným typem. Informace o operátoru testování is typu naleznete v části operátor testování typu a přetypování článku. Operátor můžete použít is také k porovnání výrazu se vzorem, jak ukazuje následující příklad:

static bool IsFirstFridayOfOctober(DateTime date) =>
    date is { Month: 10, Day: <=7, DayOfWeek: DayOfWeek.Friday };

V předchozím příkladu is operátor odpovídá výrazu proti vzoru vlastnosti s vnořenými konstantními a relačními vzory.

Operátor is může být užitečný v následujících scénářích:

  • Pokud chcete zkontrolovat typ běhu výrazu, jak ukazuje následující příklad:

    int i = 34;
    object iBoxed = i;
    int? jNullable = 42;
    if (iBoxed is int a && jNullable is int b)
    {
        Console.WriteLine(a + b);  // output 76
    }
    

    Předchozí příklad ukazuje použití vzoru deklarace.

  • Pokud chcete zkontrolovat null, jak ukazuje následující příklad:

    if (input is null)
    {
        return;
    }
    

    Při porovnávání výrazu nulls kompilátorem zaručuje, že se nevyvolá žádný přetížený == uživatel nebo != operátor.

  • Vzor negace můžete použít k provedení kontroly, která není null, jak ukazuje následující příklad:

    if (result is not null)
    {
        Console.WriteLine(result.ToString());
    }
    
  • Počínaje jazykem C# 11 můžete použít vzory seznamů ke shodě prvků seznamu nebo pole. Následující kód zkontroluje pole pro celočíselné hodnoty v očekávaných pozicích:

    int[] empty = [];
    int[] one = [1];
    int[] odd = [1, 3, 5];
    int[] even = [2, 4, 6];
    int[] fib = [1, 1, 2, 3, 5];
    
    Console.WriteLine(odd is [1, _, 2, ..]);   // false
    Console.WriteLine(fib is [1, _, 2, ..]);   // true
    Console.WriteLine(fib is [_, 1, 2, 3, ..]);     // true
    Console.WriteLine(fib is [.., 1, 2, 3, _ ]);     // true
    Console.WriteLine(even is [2, _, 6]);     // true
    Console.WriteLine(even is [2, .., 6]);    // true
    Console.WriteLine(odd is [.., 3, 5]); // true
    Console.WriteLine(even is [.., 3, 5]); // false
    Console.WriteLine(fib is [.., 3, 5]); // true
    

Poznámka:

Úplný seznam vzorů podporovaných operátorem is najdete v tématu Vzory.

specifikace jazyka C#

Další informace naleznete v části Operátor specifikace jazyka C# a porovnávání vzorů.

Viz také