Встроенные числовые преобразования (справочник по C#)

C# предоставляет набор целочисленных и числовых типов с плавающей запятой . Существует преобразование между двумя числовыми типами, неявными или явными. Для выполнения явного преобразования необходимо использовать выражение приведения .

Неявные числовые преобразования

В следующей таблице показаны предопределенные неявные преобразования между встроенными числовыми типами:

От	Кому
знаковый байт	short, int, longdoublefloatdecimalилиnint
байт	short, ushort, intfloatuintulongdoublelongdecimal, или nintnuint
короткие	int, , long, doublefloatили decimalnint
ushort	int, uint, , ulonglongdoublefloatили , или decimalnintnuint
int	long, , floatdoubleили decimal,nint
uint	long, , ulong, doublefloatили decimalnuint
длинный	float, double или decimal
ulong	float, double или decimal
float	double
nint	long, float, doubleили decimal
nuint	ulong, float, doubleили decimal

Замечание

Неявные преобразования из int, , uint, nintlongulongили из long, или floatnuint из , ulongnintили nuintdouble могут привести к потере точности, но никогда не потеря порядка величины. Другие неявные числовые преобразования никогда не теряют никаких сведений.

Кроме того, обратите внимание на то, что

• Любой целочисленный числовый тип неявно преобразуется в любой числовый тип с плавающей запятой.

• Неявные преобразования в byte и sbyte типы отсутствуют. Неявные преобразования из double и decimal типов отсутствуют.

• Нет неявных преобразований между типом decimal и floatdouble типами.

• Значение константного выражения типа int (например, значение, представленное целым литералом), может быть неявно преобразовано в sbyte, byte, , , ushortulongnintshortuint, илиnuint, если он находится в диапазоне типа назначения:

  byte a = 13;
  byte b = 300;  // CS0031: Constant value '300' cannot be converted to a 'byte'
  

  Как показано в предыдущем примере, если константное значение не находится в диапазоне конечного типа, возникает ошибка компилятора CS0031 .

Явные числовые преобразования

В следующей таблице показаны предопределенные явные преобразования между встроенными числовыми типами, для которых не существует неявного преобразования:

От	Кому
знаковый байт	byte, ushort, uint, ulong или nuint
байт	sbyte
короткие	sbyte, byte, ushort, uint, ulong или nuint
ushort	sbyte, byte или short
int	sbyte, byte, shortuintushortulongилиnuint
uint	sbyte, byte, short, ushort, int или nint
длинный	sbyte, byte, short, ushort, int, uint, ulong, nint или nuint
ulong	sbyte, byte, short, ushort, int, uint, long, nint или nuint
float	sbyte, byte, shortlongushortuintulongintdecimal, или nintnuint
двойной	sbyte, byte, shortlongushortfloatintnintuintulongdecimalилиnuint
десятичное	sbyte, byte, shortlongushortfloatintnintuintulongdoubleилиnuint
nint	sbyte, byte, , ushortshortintuintulongилиnuint
nuint	sbyte, byte, , ushortshortintuintlongилиnint

Замечание

Явное числовое преобразование может привести к потере данных или возникновению исключения, как правило OverflowException, .

Кроме того, обратите внимание на следующее:

• При преобразовании значения целочисленного типа в другой целочисленный тип результат зависит от контекста проверки переполнения. В проверяемом контексте преобразование завершается успешно, если исходное значение находится в диапазоне целевого типа. В противном случае выбрасывается OverflowException. В незаверяемом контексте преобразование всегда выполняется успешно и выполняется следующим образом:

  • Если исходный тип больше целевого типа, то исходное значение усечено путем отмены его "дополнительных" наиболее значимых битов. Результат затем обрабатывается как значение целевого типа.

  • Если исходный тип меньше конечного типа, то исходное значение расширяется с помощью знака или нуля, чтобы оно было того же размера, как целевой тип. Расширение знака используется, если исходный тип имеет знак; расширение нулём используется, если исходный тип без знака. Результат затем обрабатывается как значение целевого типа.

  • Если исходный тип совпадает с типом назначения, то исходное значение рассматривается как значение целевого типа.

• При преобразовании значения в целочисленный decimal тип это значение округляется до нуля до ближайшего целочисленного значения. Если результирующее целочисленное значение выходит за пределы диапазона целевого типа, OverflowException создается исключение.

• При преобразовании double или float значении в целочисленный тип это значение округляется до нуля до ближайшего целочисленного значения. Если результирующее целочисленное значение находится вне диапазона целевого типа, результат зависит от контекста проверки переполнения. В проверяемом контексте создается исключение, в то время как в незавершенном контексте OverflowException результат является неопределенным значением целевого типа.

• При преобразовании doublefloatв double значение округляется до ближайшего float значения. double Если значение слишком мало или слишком большое, чтобы поместиться в float тип, результат равен нулю или бесконечности.

• При преобразовании float или doubledecimalпереходе исходное значение преобразуется в decimal представление и округляется до ближайшего числа после 28-го десятичного разряда при необходимости. В зависимости от значения исходного значения может произойти одно из следующих результатов:

  • Если исходное значение слишком мало для представления в виде decimal, результат становится нулевым.

  • Если исходное значение — NaN (не число), бесконечность или слишком большое значение, которое должно быть представлено как decimal, OverflowException вызывается.

• При преобразовании decimalfloat в или double, исходное значение округляется до ближайшего float или double значения соответственно.

Спецификация языка C#

Дополнительные сведения см. в следующих разделах статьи Спецификация языка C#:

• Неявные числовые преобразования
• Явные числовые преобразования

См. также

• Преобразование приведения и типов