instanceof演算子を使用して、ある型から別の型へのキャストが安全かどうかを実行時に確認できます。キャストまたは変換中に情報が失われたり、例外がスローされたりしない場合、キャストまたは変換は安全です。instanceof演算子を使用して、2つの参照型または2つのプリミティブ型の間でキャストが安全かどうかをテストできます。また、変換の安全性は、switch文および式の動作に影響します。

次の例では、instanceofを型比較演算子として使用して、Shape sがCircleかどうかをテストします。Circleである場合、Shape sをCircleにキャストすることは安全です。つまり、出力できる半径が間違いなく存在します:

public interface Shape { }
record Rectangle(double length, double width) implements Shape { }
record Circle(double radius) implements Shape { }
//...

Shape s = new Rectangle(4,3);
if (s instanceof Circle) {
    Circle c = (Circle)s;
    System.out.println("Radius: " + c.radius());
}

Javaランタイムは、参照型を別の参照型にキャストできない場合、ClassCastExceptionをスローします。s instanceof Circle式をこの例から削除した場合、Javaランタイムは、RectangleであるShapeをCircleにキャストしようとしたときに、例外をスローします:

Shape s = new Rectangle(4,3);

// ClassCastException: class Rectangle cannot be cast
// to class Circle
Circle c = (Circle)s;

System.out.println("Radius: " + c.radius());

プリミティブ型間のキャストの場合、JavaランタイムがClassCastExceptionをスローすることはありません。値を変換した結果(型に互換性がある場合)、値の全体的な大きさと精度および範囲に関する情報が失われる可能性があります。次の例では、intをbyteにキャストします:

int i = 2345323;
byte b = (byte)i;
System.out.println(b);

次のように出力されます。

107

2345323から107のように不適切に、または意図せず変換された値、あるいは2.05fから2のようにわずかに変換された値は、プログラム全体に静かに伝播して、見つけにくいbugの原因になる可能性があります。

プリミティブ型のintとbyteは範囲が異なるため、値をキャストする前にそれをテストできます:

if (i >= -128 && i <= 127) {
    System.out.println((byte)i);
}

ただし、2つのプリミティブ型間のキャストが安全かどうかをより明確かつ簡潔にテストする方法は、instanceofを型比較演算子として使用することです:

if (i instanceof byte) {
    System.out.println((byte)i);
}

この例では、依然として値iをbyteにキャストする必要があります。instanceof型比較演算子は、iがbyteかどうかをチェックするのみです。実際のキャストは実行しません。

instanceofをパターン一致演算子として使用する方法もありますが、その方法には、テストが成功した場合にキャストが実行されるという追加の利点があります:

if (i instanceof byte b) {
    System.out.println(b);
}