CKTIS / Java
instanceof — Typmuster und Flow Scoping
Der Operator instanceof prüft, ob ein Objekt mit einem Typ kompatibel ist, und liefert boolean. Ein Typmuster kann außerdem eine Variable deklarieren, die überall dort verfügbar ist, wo der Compiler die erfolgreiche Übereinstimmung nachweisen kann. Für null ist das Ergebnis false.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
expression instanceof ReferenceType
expression instanceof ReferenceType variableinstanceof ist ein Schlüsselwort, das als Operator verwendet wird. In Java SE 21 muss sein linker Operand einen Referenztyp oder den null-Typ haben. Die Form value instanceof String prüft, ob eine nicht-null Referenz ohne ClassCastException in String umgewandelt werden könnte; das Ergebnis ist boolean. Der Test umfasst kompatible Untertypen und Implementierungen von Schnittstellen, nicht nur eine exakte Klasse. Für null liefert er false.
Ein Typmuster wie value instanceof String text verbindet den Test mit der Deklaration einer Variablen text vom Typ String. Bei einer Übereinstimmung verweist sie auf dasselbe Objekt, daher ist keine explizite Umwandlung nötig. Tests, die aufgrund der Operandentypen unzulässig sind, führen zu Kompilierungsfehlern und liefern nicht einfach false.
Flow Scoping bedeutet, dass der Gültigkeitsbereich vom Kontrollfluss abhängt: Die Variable ist überall dort verfügbar, wo der Compiler nachweisen kann, dass das Muster übereinstimmt. Bei value instanceof String text && text.length() > 3 wird die rechte Seite von && nur nach einem erfolgreichen Test ausgeführt. Dagegen lässt sich value instanceof String text || text.isEmpty() nicht kompilieren: Die rechte Seite kann ausgeführt werden, nachdem die Übereinstimmung fehlgeschlagen ist.
Der Gültigkeitsbereich einer Mustervariablen kann über die if-Anweisung hinausreichen. Nach if (!(value instanceof String text)) { return 0; } ist text in den folgenden Anweisungen desselben umschließenden Blocks verfügbar, weil return die Methode bei fehlender Übereinstimmung beendet. Im Beispiel steht die if-Anweisung direkt im Methodenrumpf. Steht sie in einem verschachtelten Block, ist text außerhalb dieses Blocks nicht verfügbar. Das Beispiel zeigt auch die Verwendung von && sowie das Verhalten bei einem anderen Typ und bei null.
Beispiele
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));
}
}Ergebnis
4 2 0 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.