Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

instanceof — padrões de tipo e âmbito dependente do fluxo

O operador instanceof testa a compatibilidade de um objeto com um tipo e devolve boolean. Um padrão de tipo também pode declarar uma variável disponível onde quer que o compilador consiga provar que houve correspondência. Para null, o resultado é false.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

expression instanceof ReferenceType
expression instanceof ReferenceType variable

instanceof é uma palavra-chave utilizada como operador. Em Java SE 21, o operando esquerdo tem de ter um tipo de referência ou o tipo null. A forma value instanceof String verifica se uma referência não nula poderia ser convertida para String sem ClassCastException; o resultado é boolean. O teste inclui subtipos compatíveis e implementações de interfaces, não apenas uma classe exata. Para null, devolve false.

Um padrão de tipo, como value instanceof String text, combina o teste com a declaração de uma variável text do tipo String. Em caso de correspondência, refere-se ao mesmo objeto, pelo que não é necessária uma conversão explícita. Os testes não permitidos pelos tipos dos operandos causam erros de compilação; não são simplesmente testes que devolvem false.

O âmbito dependente do fluxo faz com que o âmbito dependa do fluxo de controlo: a variável está disponível onde quer que o compilador consiga provar que o padrão correspondeu. Em value instanceof String text && text.length() > 3, o lado direito de && só é executado após um teste bem-sucedido. Por outro lado, value instanceof String text || text.isEmpty() não compila: o lado direito pode ser executado depois de a correspondência falhar.

O âmbito de uma variável do padrão pode estender-se para além da instrução if. Após if (!(value instanceof String text)) { return 0; }, text está disponível nas instruções seguintes do mesmo bloco que contém o if, porque return termina a execução do método se não houver correspondência. No exemplo, a instrução if encontra-se diretamente no corpo do método. Se estiver num bloco aninhado, text não está disponível fora desse bloco. O exemplo mostra também a utilização de && e o comportamento com outro tipo e com null.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes