Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

instanceof — patrones de tipo y ámbito según el flujo

El operador instanceof comprueba si un objeto es compatible con un tipo y devuelve boolean. Un patrón de tipo también puede declarar una variable disponible allí donde el compilador pueda demostrar que la coincidencia se ha producido. Para null, el resultado es false.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

expression instanceof ReferenceType
expression instanceof ReferenceType variable

instanceof es una palabra clave que se utiliza como operador. En Java SE 21, su operando izquierdo debe tener un tipo de referencia o el tipo null. La forma value instanceof String comprueba si una referencia no nula podría convertirse a String sin ClassCastException; el resultado es boolean. La comprobación incluye subtipos compatibles e implementaciones de interfaces, no solo una clase exacta. Para null, devuelve false.

Un patrón de tipo, como value instanceof String text, combina la comprobación con la declaración de una variable text de tipo String. Si hay coincidencia, hace referencia al mismo objeto, por lo que no hace falta una conversión explícita. Las comprobaciones no permitidas por los tipos de los operandos producen errores de compilación, no son simplemente comprobaciones que devuelven false.

El ámbito según el flujo hace que el ámbito dependa del flujo de control: la variable está disponible allí donde el compilador pueda demostrar que el patrón coincide. En value instanceof String text && text.length() > 3, el lado derecho de && solo se ejecuta después de una comprobación satisfactoria. En cambio, value instanceof String text || text.isEmpty() no compila: su lado derecho puede ejecutarse después de que la coincidencia haya fallado.

El ámbito de una variable de patrón puede extenderse más allá de la instrucción if. Después de if (!(value instanceof String text)) { return 0; }, text está disponible en las instrucciones siguientes del mismo bloque que contiene el if, porque return sale del método si no hay coincidencia. En el ejemplo, la instrucción if está directamente en el cuerpo del método. Si está en un bloque anidado, text no está disponible fuera de ese bloque. El ejemplo también muestra el uso de && y el comportamiento con otro tipo y con null.

Ejemplos

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));
    }
}

Resultado

4
2
0
0

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes