次の方法で共有

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());
}

  • C# 11 以降では、 リスト パターン を使用してリストまたは配列の要素を照合できます。 次のコードは、配列で予期される位置の整数値をチェックします。

    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 演算子のセクションを参照してください。

こちらも参照ください