Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 variable

instanceof 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.

Źródła