CKTIS / Java
Class.cast — kontrolované přetypování pomocí Class<T>
Je-li cílový typ uložen v proměnné `Class<T>`, metoda `cast` vrátí referenci typu `T` na stejný objekt. Pomocí `isInstance` lze před přetypováním ověřit hodnotu odlišnou od `null`.
Verze: 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 je instanční metoda třídy java.lang.Class<T>. Volání type.cast(value) za běhu ověří, zda je hodnota kompatibilní s typem reprezentovaným objektem type. Vrátí referenci na stejný objekt se statickým typem T. Objekt nekopíruje ani nemění. Kontrolou může projít i instance podtřídy nebo objekt implementující cílové rozhraní.
Pokud type.isInstance(value) vrátí true, můžeš ve větvi if zavolat type.cast(value) se stejnou hodnotou. isInstance vrací pouze logickou hodnotu a nemění typ proměnné value. Pro null vrací isInstance hodnotu false, zatímco cast vrací null. Nekompatibilní argument odlišný od null vyvolá ClassCastException.
Když je cílový typ uveden přímo v kódu, můžeš napsat (CharSequence) value. Použij type.cast(value), když se typ předává jako Class<T>. Metoda neprovádí číselné konverze a List.class.cast(value) neověřuje, zda jsou prvky seznamu objekty typu String.
Příklady
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");
}
}
}Výsledek
length: 4 same object: true isInstance(null): false cast(null): null incompatible: ClassCastException
`StringBuilder` implementuje `CharSequence`, takže po kontrole můžeš přes `text` zavolat `length()`. Porovnání pomocí `==` potvrzuje, že obě reference odkazují na stejný objekt. Zbývající řádky ukazují rozdíl pro `null` a výjimku pro nekompatibilní `Integer`.
Související lekce
- Java · Lekce 36 · Středně pokročilá · Verze: 2
- Java · Lekce 37 · Středně pokročilá · Verze: 2