operador is (referência C#)

O is operador verifica se o resultado de uma expressão é compatível com um determinado tipo. Para obter informações sobre o operador de teste is de tipo, consulte a seção é operador do artigo Operadores de teste de tipo e fundidos . Você também pode usar o is operador para corresponder uma expressão a um padrão, como mostra o exemplo a seguir:

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

No exemplo anterior, o is operador faz a correspondência de uma expressão com um padrão de propriedade com padrões constantes e relacionais aninhados.

O is operador pode ser útil nos seguintes cenários:

  • Para verificar o tipo de tempo de execução de uma expressão, como mostra o exemplo a seguir:

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

    O exemplo anterior mostra o uso de um padrão de declaração.

  • Para verificar nullo , como mostra o exemplo a seguir:

    if (input is null)
    {
        return;
    }
    

    Quando você faz a correspondência entre uma expressão nulle , o compilador garante que nenhum operador ou sobrecarregado == pelo usuário seja != invocado.

  • Você pode usar um padrão de negação para fazer uma verificação não nula, como mostra o exemplo a seguir:

    if (result is not null)
    {
        Console.WriteLine(result.ToString());
    }
    
  • A partir do C# 11, você pode usar padrões de lista para corresponder elementos de uma lista ou matriz. O código a seguir verifica matrizes para valores inteiros em posições esperadas:

    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
    

Nota

Para obter a lista completa de padrões suportados is pelo operador, consulte Padrões.

Especificação da linguagem C#

Para obter mais informações, consulte a seção O operador is da especificação da linguagem C# e Correspondência de padrões.

Consulte também