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 variableinstanceof é 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.