CKTIS / Java
instanceof — pattern di tipo e ambito legato al flusso
L’operatore instanceof verifica la compatibilità di un oggetto con un tipo e restituisce boolean. Un pattern di tipo può anche dichiarare una variabile disponibile ovunque il compilatore possa dimostrare che la corrispondenza è riuscita. Per null, il risultato è false.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
expression instanceof ReferenceType
expression instanceof ReferenceType variableinstanceof è una parola chiave usata come operatore. In Java SE 21, il suo operando sinistro deve avere un tipo riferimento oppure il tipo null. La forma value instanceof String verifica se un riferimento non nullo potrebbe essere convertito in String senza ClassCastException; il risultato è boolean. Il test comprende sottotipi compatibili e implementazioni di interfacce, non solo una classe esatta. Per null, restituisce false.
Un pattern di tipo, ad esempio value instanceof String text, combina il test con la dichiarazione di una variabile text di tipo String. In caso di corrispondenza, la variabile indica lo stesso oggetto, quindi non serve una conversione esplicita. I test non consentiti dai tipi degli operandi causano errori di compilazione, non sono semplicemente test che restituiscono false.
L’ambito legato al flusso fa dipendere l’ambito dal flusso di controllo: la variabile è disponibile ovunque il compilatore possa dimostrare che il pattern ha trovato corrispondenza. In value instanceof String text && text.length() > 3, il lato destro di && viene eseguito solo dopo un test riuscito. Invece, value instanceof String text || text.isEmpty() non viene compilato: il lato destro può essere eseguito dopo che la corrispondenza è fallita.
L’ambito di una variabile del pattern può estendersi oltre l’istruzione if. Dopo if (!(value instanceof String text)) { return 0; }, text è disponibile nelle istruzioni successive dello stesso blocco che contiene l’if, perché return esce dal metodo se non c’è corrispondenza. Nell’esempio, l’istruzione if si trova direttamente nel corpo del metodo. Se si trova in un blocco annidato, text non è disponibile al di fuori di quel blocco. L’esempio mostra anche l’uso di && e il comportamento con un altro tipo e con null.
Esempi
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));
}
}Risultato
4 2 0 0
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.