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

CKTIS / Java

Class.cast — conversion de référence vérifiée avec Class<T>

Si le type cible est fourni dans une variable `Class<T>`, `cast` renvoie une référence de type `T` vers le même objet. `isInstance` permet de vérifier une valeur non nulle avant la conversion.

Version : Java SE 21

Syntaxe

public T cast(Object obj)

// Instance method of java.lang.Class<T>:
// For Class<T> type and Object value:
T result = type.cast(value);

Class.cast est une méthode d’instance de java.lang.Class<T>. L’appel type.cast(value) vérifie à l’exécution que la valeur est compatible avec le type représenté par type. Il renvoie une référence vers le même objet, de type statique T. Il ne copie ni ne modifie l’objet. Une instance d’une sous-classe ou un objet qui implémente l’interface cible peut aussi réussir la vérification.

Si type.isInstance(value) renvoie true, tu peux appeler type.cast(value) sur la même valeur dans le bloc if. isInstance renvoie seulement un booléen et ne change pas le type de value. Pour null, isInstance renvoie false, alors que cast renvoie null. Un argument non nul incompatible déclenche une ClassCastException.

Quand le type cible est nommé directement dans le code, tu peux écrire (CharSequence) value. Utilise type.cast(value) lorsque le type est passé sous forme de Class<T>. La méthode n’effectue pas de conversion numérique, et List.class.cast(value) ne vérifie pas que les éléments de la liste sont des objets String.

Exemples

public class Main {
    public static void main(String[] args) {
        Class<CharSequence> type = CharSequence.class;
        Object value = new StringBuilder("Java");

        if (type.isInstance(value)) {
            CharSequence text = type.cast(value);
            System.out.println("length: " + text.length());
            System.out.println("same object: " + (text == value));
        }

        System.out.println("isInstance(null): " + type.isInstance(null));
        System.out.println("cast(null): " + type.cast(null));

        try {
            type.cast(Integer.valueOf(7));
        } catch (ClassCastException e) {
            System.out.println("incompatible: ClassCastException");
        }
    }
}

Résultat

length: 4
same object: true
isInstance(null): false
cast(null): null
incompatible: ClassCastException

`StringBuilder` implémente `CharSequence` : après la vérification, tu peux donc appeler `length()` via `text`. La comparaison `==` confirme que les deux références désignent le même objet. Les lignes suivantes montrent la différence pour `null` et l’exception pour un `Integer` incompatible.

Leçons associées

  • Java · Leçon 36 · Intermédiaire · Version : 2
  • Java · Leçon 37 · Intermédiaire · Version : 2

Sources