Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

instanceof — motifs de type et portée liée au flux

L’opérateur instanceof vérifie la compatibilité d’un objet avec un type et renvoie boolean. Un motif de type peut aussi déclarer une variable disponible partout où le compilateur peut prouver que la correspondance a réussi. Pour null, le résultat est false.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

expression instanceof ReferenceType
expression instanceof ReferenceType variable

instanceof est un mot-clé utilisé comme opérateur. En Java SE 21, son opérande gauche doit être de type référence ou de type null. La forme value instanceof String vérifie si une référence non nulle pourrait être convertie en String sans ClassCastException ; le résultat est boolean. Le test inclut les sous-types compatibles et les implémentations d’interfaces, et pas seulement une classe exacte. Pour null, il renvoie false.

Un motif de type, par exemple value instanceof String text, associe le test à la déclaration d’une variable text de type String. En cas de correspondance, elle désigne le même objet : aucune conversion explicite n’est donc nécessaire. Les tests interdits par les types des opérandes provoquent des erreurs de compilation ; ils ne renvoient pas simplement false.

La portée liée au flux signifie que la portée dépend du flux de contrôle : la variable est disponible partout où le compilateur peut prouver que le motif correspond. Dans value instanceof String text && text.length() > 3, le membre de droite de && n’est exécuté qu’après un test réussi. En revanche, value instanceof String text || text.isEmpty() ne compile pas : son membre de droite peut s’exécuter après un échec de la correspondance.

La portée d’une variable de motif peut s’étendre au-delà de l’instruction if. Après if (!(value instanceof String text)) { return 0; }, text est disponible dans les instructions suivantes du même bloc englobant, car return quitte la méthode en l’absence de correspondance. Dans l’exemple, l’instruction if se trouve directement dans le corps de la méthode. Si elle se trouve dans un bloc imbriqué, text n’est pas disponible en dehors de ce bloc. L’exemple montre aussi l’utilisation de && et le comportement avec un autre type et avec null.

Exemples

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

Résultat

4
2
0
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources