CKTIS / Java
Class.cast — preverjeno pretvarjanje tipa s Class<T>
Če je ciljni tip podan v spremenljivki `Class<T>`, `cast` vrne referenco tipa `T` na isti objekt. Z `isInstance` lahko pred pretvorbo preveriš vrednost, ki ni `null`.
Različica: Java SE 21
Sintaksa
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 metoda primerka razreda java.lang.Class<T>. Klic type.cast(value) med izvajanjem preveri, ali je vrednost združljiva s tipom, ki ga predstavlja type. Vrne referenco na isti objekt, pri čemer je statični tip rezultata T. Objekta ne kopira in ga ne spremeni. Preverjanje lahko prestane tudi primerek podrazreda ali objekt, ki implementira ciljni vmesnik.
Če type.isInstance(value) vrne true, lahko v veji if pokličeš type.cast(value) z isto vrednostjo. isInstance vrne samo logično vrednost in ne spremeni tipa spremenljivke value. Za null metoda isInstance vrne false, metoda cast pa vrne null. Nezdružljiv argument, ki ni null, sproži izjemo ClassCastException.
Kadar je ciljni tip naveden neposredno v kodi, lahko napišeš (CharSequence) value. Uporabi type.cast(value), kadar je tip podan kot Class<T>. Metoda ne izvaja številskih pretvorb, List.class.cast(value) pa ne preverja, ali so elementi seznama objekti tipa String.
Primeri
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");
}
}
}Rezultat
length: 4 same object: true isInstance(null): false cast(null): null incompatible: ClassCastException
`StringBuilder` implementira `CharSequence`, zato lahko po preverjanju prek `text` pokličeš `length()`. Primerjava z `==` potrdi, da obe referenci kažeta na isti objekt. Preostale vrstice pokažejo razliko pri `null` in izjemo za nezdružljiv objekt tipa `Integer`.
Povezane lekcije
- Java · Lekcija 36 · Srednja · Različica: 2
- Java · Lekcija 37 · Srednja · Različica: 2