CKTIS / Java
instanceof — wzorzec typu i zakres zależny od przepływu sterowania
Operator instanceof sprawdza zgodność obiektu z typem i zwraca boolean. Wzorzec typu może dodatkowo zadeklarować zmienną dostępną tam, gdzie kompilator potrafi dowieść dopasowania. Dla null wynik jest false.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
expression instanceof ReferenceType
expression instanceof ReferenceType variableinstanceof jest słowem kluczowym używanym jako operator. W Java SE 21 lewy operand musi mieć typ referencyjny albo typ null. Postać value instanceof String sprawdza, czy niepustą referencję można rzutować na String bez ClassCastException; wynikiem jest boolean. Test obejmuje również zgodne podtypy i implementacje interfejsów, a nie tylko dokładną klasę. Dla null zwraca false.
Wzorzec typu, np. value instanceof String text, łączy test z deklaracją zmiennej text typu String. Po dopasowaniu wskazuje ona ten sam obiekt, więc jawne rzutowanie nie jest potrzebne. Testy niedopuszczalne ze względu na typy operandów są błędami kompilacji, a nie po prostu testami zwracającymi false.
Flow scoping oznacza zakres zależny od przepływu sterowania: zmienna jest dostępna tam, gdzie kompilator potrafi dowieść dopasowania wzorca. W value instanceof String text && text.length() > 3 prawa strona && wykonuje się tylko po udanym teście. Natomiast value instanceof String text || text.isEmpty() nie kompiluje się: prawa strona może wykonać się po nieudanym dopasowaniu.
Zakres zmiennej wzorca może wykraczać poza instrukcję if. Po if (!(value instanceof String text)) { return 0; } zmienna text jest dostępna w kolejnych instrukcjach tego samego bloku, ponieważ przy braku dopasowania return kończy wykonanie metody. W przykładzie instrukcja if znajduje się bezpośrednio w ciele metody. Gdy taka instrukcja znajduje się w bloku zagnieżdżonym, text nie jest dostępna poza tym blokiem. Przykład pokazuje też użycie && oraz zachowanie dla innego typu i null.
Przykłady
public class Main {
static int lengthOrZero(Object value) {
if (!(value instanceof String text)) {
return 0;
}
return text.length();
}
public static void main(String[] args) {
Object value = "Java";
if (value instanceof String text && text.length() > 3) {
System.out.println(text.length());
}
System.out.println(lengthOrZero("OK"));
System.out.println(lengthOrZero(42));
System.out.println(lengthOrZero(null));
}
}Wynik
4 2 0 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.