CKTIS / Java
instanceof — typové vzory a rozsah závislý na toku řízení
Operátor instanceof testuje kompatibilitu objektu s typem a vrací boolean. Typový vzor může také deklarovat proměnnou dostupnou všude, kde kompilátor dokáže prokázat úspěšnou shodu. Pro null je výsledek false.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
expression instanceof ReferenceType
expression instanceof ReferenceType variableinstanceof je klíčové slovo používané jako operátor. V Java SE 21 musí mít jeho levý operand referenční typ nebo typ null. Tvar value instanceof String testuje, zda lze nenulový odkaz převést na String bez výjimky ClassCastException; výsledkem je boolean. Test zahrnuje kompatibilní podtypy a implementace rozhraní, nejen přesnou třídu. Pro null vrací false.
Typový vzor, například value instanceof String text, spojuje test s deklarací proměnné text typu String. Při shodě odkazuje na tentýž objekt, takže není potřeba explicitní převod. Testy, které nejsou kvůli typům operandů povolené, jsou chybami kompilace, nikoli pouze testy vracejícími false.
Rozsah závislý na toku řízení znamená, že rozsah závisí na toku řízení: proměnná je dostupná všude, kde kompilátor dokáže prokázat shodu vzoru. V value instanceof String text && text.length() > 3 se pravá strana && provede pouze po úspěšném testu. Naproti tomu value instanceof String text || text.isEmpty() se nezkompiluje: pravá strana se může provést po neúspěšné shodě.
Rozsah proměnné vzoru může přesahovat příkaz if. Po if (!(value instanceof String text)) { return 0; } je text dostupná v následujících příkazech téhož bloku, který příkaz if obsahuje, protože při neshodě return ukončí provádění metody. V příkladu je příkaz if přímo v těle metody. Pokud je ve vnořeném bloku, text mimo tento blok není dostupná. Příklad ukazuje také použití && a chování pro jiný typ a pro null.
Příklady
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));
}
}Výsledek
4 2 0 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.