CKTIS / C#
Explicitní přetypování: (T)expression
Výraz `(T)expression` explicitně převede výsledek výrazu `expression` na typ `T`. Může jít o číselnou konverzi, konverzi reference, unboxing nebo uživatelsky definovanou konverzi. Úspěch není zaručen: může dojít ke ztrátě dat nebo vyvolání výjimky.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
(T)expressionVýraz (T)expression požaduje explicitní konverzi: T je cílový typ a expression poskytuje převáděnou hodnotu. Přetypování může požadovat také konverzi, která je dostupná implicitně. Pokud neexistuje použitelná konverze, kompilátor kód odmítne; přidání (T) neumožňuje libovolné převody mezi typy.
Číselné konverze mohou vést ke ztrátě informací. U konečné hodnoty double, jejíž celočíselná část se vejde do int, výraz (int)value zahodí desetinnou část směrem k nule: -12.75 se změní na -12, nikoli na -13. Při zužující konverzi mezi celočíselnými typy v kontextu checked konverze vyvolá výjimku OverflowException, pokud hodnota zjištěná za běhu leží mimo rozsah cílového typu. Je-li operand konstantní výraz s hodnotou mimo tento rozsah, konverze v kontextu checked způsobí chybu při kompilaci, například u checked((byte)256). V kontextu unchecked taková zužující konverze zahodí přebytečné bity. Toto pravidlo nelze zobecnit na všechny číselné konverze.
Konverze reference nemění objekt ani jeho běhový typ. Přetypování nekompatibilního objektu může vyvolat InvalidCastException; přetypování reference null na referenční typ stále vrátí null. Pokud zdrojová reference není null, unboxing vyžaduje zabalenou hodnotu odpovídajícího typu: pokud boxed obsahuje int, výraz (long)boxed vyvolá InvalidCastException, ale (long)(int)boxed nejprve rozbalí int a potom jej převede na long. Unboxing reference null na hodnotový typ s podporou null dává null: například (int?)(object)null dává null typu int?, aniž by existovala zabalená hodnota.
Na rozdíl od přetypování is ověřuje kompatibilitu, zatímco as při nekompatibilitě vrátí null a nepodporuje číselné ani uživatelsky definované konverze. Typ může definovat konverzní operátory implicit a explicit, které přetypování používá; samotný operátor () přetížit nelze. Příklad ukazuje odříznutí desetinné části, unboxing následovaný rozšířením a konverzi reference.
Příklady
using System;
internal static class Program
{
private static void Main()
{
double value = -12.75;
int whole = (int)value;
Console.WriteLine(whole);
object boxed = 42;
long widened = (long)(int)boxed;
Console.WriteLine(widened);
object text = "hello";
string word = (string)text;
Console.WriteLine(word.Length);
}
}Výsledek
-12 42 5
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.