CKTIS / C#
Explicitné pretypovanie: (T)expression
Výraz `(T)expression` explicitne konvertuje výsledok výrazu `expression` na typ `T`. Môže ísť o číselnú konverziu, konverziu referencie, unboxing alebo používateľom definovanú konverziu. Úspech nie je zaručený: môže dôjsť k strate údajov alebo vyvolaniu výnimky.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
(T)expressionVýraz (T)expression požaduje explicitnú konverziu: T je cieľový typ a expression poskytuje hodnotu, ktorá sa má konvertovať. Pretypovanie môže požadovať aj konverziu dostupnú implicitne. Ak neexistuje použiteľná konverzia, kompilátor kód odmietne; pridaním (T) sa nepovolia ľubovoľné konverzie medzi typmi.
Číselné konverzie môžu viesť k strate informácií. Pri konečnej hodnote double, ktorej celočíselná časť sa zmestí do int, výraz (int)value odstráni zlomkovú časť smerom k nule: -12.75 sa zmení na -12, nie na -13. Pri zužujúcej konverzii medzi celočíselnými typmi v kontexte checked konverzia vyvolá výnimku OverflowException, ak je hodnota zistená za behu mimo rozsahu cieľového typu. Ak je operand konštantný výraz s hodnotou mimo tohto rozsahu, konverzia v kontexte checked spôsobí chybu pri kompilácii, napríklad pri checked((byte)256). V kontexte unchecked takáto zužujúca konverzia zahodí nadbytočné bity. Toto pravidlo nezovšeobecňujte na všetky číselné konverzie.
Konverzia referencie nemení objekt ani jeho runtime typ. Pretypovanie nekompatibilného objektu môže vyvolať InvalidCastException; pretypovanie referencie null na referenčný typ stále vráti null. Ak zdrojová referencia nie je null, unboxing vyžaduje zabalenú hodnotu vhodného typu: ak boxed obsahuje int, výraz (long)boxed vyvolá InvalidCastException, ale (long)(int)boxed najprv rozbalí int a potom ho konvertuje na long. Konverzia unboxingom z referencie null na hodnotový typ, ktorý pripúšťa null, dáva null: napríklad (int?)(object)null dáva null typu int?, hoci žiadna zabalená hodnota neexistuje.
Na rozdiel od pretypovania is kontroluje kompatibilitu, zatiaľ čo as pri nekompatibilite vráti null a nepodporuje číselné ani používateľom definované konverzie. Typ môže definovať konverzné operátory implicit a explicit, ktoré pretypovanie používa; samotný operátor () nemožno preťažiť. Príklad ukazuje skrátenie zlomkovej časti, unboxing nasledovaný rozšírením a konverziu referencie.
Prí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ýsledok
-12 42 5
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.