다음을 통해 공유


연산자 is (C# 참조)

연산자는 is 식의 결과가 지정된 형식과 호환되는지 확인합니다. 형식 테스트 연산자에 대한 자세한 내용은 형식 테스트 is 및 캐스트 연산 자 문서의 is 연산자 섹션을 참조하세요. 다음 예제와 같이 연산자를 is 사용하여 패턴과 식을 일치시킬 수도 있습니다.

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

앞의 예제에서 연산자는 is 중첩된 상수관계형 패턴이 있는 속성 패턴에 대해 식을 일치합니다.

연산자는 is 다음 시나리오에서 유용할 수 있습니다.

  • 다음 예제와 같이 식의 런타임 형식을 확인하려면 다음을 수행합니다.

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

    앞의 예제에서는 선언 패턴의 사용을 보여 줍니다.

  • 다음 예제와 같이 확인 null하려면 다음을 수행합니다.

    if (input is null)
    {
        return;
    }
    

    식과 null일치하면 컴파일러는 사용자 오버로드 == 또는 != 연산자가 호출되지 않도록 보장합니다.

  • 다음 예제와 같이 부정 패턴을 사용하여 null이 아닌 검사를 수행할 수 있습니다.

    if (result is not null)
    {
        Console.WriteLine(result.ToString());
    }
    
  • 목록 패턴을 사용하여 목록 또는 배열의 요소를 일치시킬 수 있습니다. 다음 코드는 예상 위치의 정수 값에 대한 배열을 확인합니다.

    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
    

비고

연산자가 지원하는 is 패턴의 전체 목록은 패턴을 참조하세요.

C# 언어 사양

자세한 내용은 C# 언어 사양패턴 일치is 연산자 섹션을 참조하세요.

참고하십시오