CKTIS / C#
Conversão explícita de tipo: (T)expression
A expressão `(T)expression` converte explicitamente o resultado de `expression` para o tipo `T`. Pode efetuar uma conversão numérica ou de referência, unboxing ou uma conversão definida pelo utilizador. O sucesso não é garantido: pode perder dados ou lançar uma exceção.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
(T)expressionA expressão (T)expression pede uma conversão explícita: T é o tipo de destino e expression fornece o valor a converter. Um cast também pode pedir uma conversão que esteja disponível implicitamente. Se não existir uma conversão aplicável, o compilador rejeita o código; acrescentar (T) não permite conversões arbitrárias entre tipos.
As conversões numéricas podem perder informação. Para um double finito cuja parte inteira caiba num int, (int)value descarta a parte fracionária em direção a zero: -12.75 passa a -12, não a -13. Ao converter para um tipo inteiro de menor amplitude num contexto checked, a conversão lança OverflowException se o valor inteiro obtido em tempo de execução estiver fora do intervalo do tipo de destino. Se o operando for uma expressão constante cujo valor esteja fora desse intervalo, a conversão num contexto checked provoca um erro de compilação, como em checked((byte)256). Num contexto unchecked, este tipo de conversão descarta os bits excedentes. Não generalize esta regra a todas as conversões numéricas.
Uma conversão de referência não altera o objeto nem o respetivo tipo em tempo de execução. Fazer cast de um objeto incompatível pode lançar InvalidCastException; fazer cast de uma referência null para um tipo de referência continua a produzir null. Se a referência de origem não for null, o unboxing exige um valor do tipo adequado que tenha sido sujeito a boxing: se boxed contiver um int, (long)boxed lança InvalidCastException, mas (long)(int)boxed primeiro desempacota o int e depois converte-o para long. Uma conversão de unboxing de uma referência null para um tipo de valor que admite null dá null: por exemplo, (int?)(object)null dá null do tipo int? sem que exista qualquer valor sujeito a boxing.
Ao contrário de um cast, is verifica a compatibilidade, enquanto as devolve null em caso de incompatibilidade e não suporta conversões numéricas nem definidas pelo utilizador. Um tipo pode definir os operadores de conversão implicit e explicit usados pelos casts; não pode sobrecarregar o próprio (). O exemplo mostra o truncamento da parte fracionária, o unboxing seguido de uma conversão para um tipo mais abrangente e uma conversão de referência.
Exemplos
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);
}
}Resultado
-12 42 5
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.