기본 제공 숫자 변환(C# 참조)

C#에서는 정수 및 부동 소수점 숫자 형식 집합을 제공합니다. 두 숫자 형식 간에는 암시적 또는 명시적 변환이 있습니다. 명시적 변환을 수행하려면 캐스트 식 사용해야 합니다.

암시적 숫자 변환

다음 표에서는 기본 제공 숫자 형식 간의 미리 정의된 암시적 숫자 변환을 보여 줍니다.

보낸 사람	수행할 작업
sbyte	short, int, long, float, double, decimal 또는 nint
바이트	short, ushort, int, uint, long, ulong, float, double, decimal, nint 또는 nuint
short	int, long, float, double 또는 decimal 또는 nint
ushort	int, uint, long, ulong, float, double 또는 decimal, nint 또는 nuint
int	long, float, double 또는 decimal, nint
uint	long, ulong, float, double 또는 decimal 또는 nuint
long	float, double 또는 decimal
ulong	float, double 또는 decimal
float	double
nint	long, float, double 또는 decimal
nuint	ulong, float, double 또는 decimal

참고 항목

int, uint, long, ulong, nint 또는 nuint에서 float로 암시적으로 변환하거나 long, ulong, nint 또는 nuint에서 double로 암시적으로 변환하는 경우 정밀도가 손실될 수도 있지만, 자릿수 손실은 없습니다. 다른 암시적 숫자 변환 시에는 정보 손실이 없습니다.

다음 사항에도 유의하세요.

• 정수 숫자 형식을 부동 소수점 숫자 형식으로 암시적으로 변환할 수 있습니다.

• byte 및 sbyte 형식으로의 암시적 변환은 없습니다. double 및 decimal 형식에서 암시적 변환은 없습니다.

• decimal 형식과 float 또는 double 형식 간의 암시적 변환은 없습니다.

• 대상 형식의 범위 내에 있는 경우 int 형식의 상수 식 값(예: 정수 리터럴로 표시된 값)을 sbyte, byte, short, ushort, uint, ulong, nint 또는 nuint으로 암시적으로 변환할 수 있습니다.

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

  위 예제에서 볼 수 있듯이, 상수 값이 대상 형식의 범위 내에 있지 않으면 컴파일러 오류 CS0031이 발생합니다.

명시적 숫자 변환

다음 표에서는 암시적 변환이 없는 기본 제공 숫자 형식 간의 미리 정의된 명시적 변환을 보여 줍니다.

보낸 사람	수행할 작업
sbyte	byte, ushort, uint, ulong 또는 nuint
바이트	sbyte
short	sbyte, byte, ushort, uint, ulong 또는 nuint
ushort	sbyte, byte 또는 short
int	sbyte, byte, short, ushort, uint, ulong 또는 nuint
uint	sbyte, byte, short, ushort, int 또는 nint
long	sbyte, byte, short, ushort, int, uint, ulong, nint 또는 nuint
ulong	sbyte, byte, short, ushort, int, uint, long, nint 또는 nuint
float	sbyte, byte, short, ushort, int, uint, long, ulong, decimal, nint 또는 nuint
double	sbyte, byte, short, ushort, int, uint, long, ulong, float, decimal, nint 또는 nuint
decimal	sbyte, byte, short, ushort, int, uint, long, ulong, float, double, nint 또는 nuint
nint	sbyte, byte, short, ushort, int, uint, ulong 또는 nuint
nuint	sbyte, byte, short, ushort, int, uint, long 또는 nint

참고 항목

명시적 숫자 변환으로 인해 데이터가 손실되거나 예외(일반적으로 OverflowException)가 throw될 수 있습니다.

다음 사항에도 유의하세요.

• 정수 형식의 값을 다른 정수 형식으로 변환하면 결과는 오버플로 검사 컨텍스트에 따라 달라집니다. 확인된 컨텍스트에서 소스 값이 대상 형식의 범위 내에 있으면 변환이 성공합니다. 그렇지 않으면 OverflowException이 throw됩니다. 확인되지 않은 컨텍스트에서 변환은 항상 성공하고 다음과 같이 진행됩니다.

  • 소스 형식이 대상 형식보다 큰 경우 소스 값은 가장 중요한 비트인 해당 "extra"를 삭제함으로써 잘립니다. 그런 다음, 결과는 대상 형식의 값으로 처리됩니다.

  • 소스 형식이 대상 형식보다 작은 경우 소스 값이 대상 형식과 크기가 같도록 부호 확장 또는 0 확장됩니다. 부호 확장은 소스 형식이 서명된 경우 사용되며, 소스 형식이 서명되지 않은 경우 0 확장이 사용됩니다. 그런 다음, 결과는 대상 형식의 값으로 처리됩니다.

  • 소스 형식이 대상 형식과 동일한 크기인 경우 소스 값은 대상 형식의 값으로 처리됩니다.

• decimal 값을 정수 형식으로 변환하면, 이 값은 0을 향한 방향으로 가장 가까운 정수값으로 반올림됩니다. 결과 정수 값이 대상 형식 범위에서 벗어났을 경우 OverflowException이 throw됩니다.

• double 또는 float 값을 정수 형식으로 변환하면, 이 값은 0을 향한 방향으로 가장 가까운 정수값으로 반올림됩니다. 결과 정수 값이 대상 형식 범위에서 벗어났을 경우 결과는 오버플로 검사 컨텍스트에 따라 달라집니다. Checked 컨텍스트에서는 OverflowException이 throw됩니다. 반면 Unchecked 컨텍스트에서 결과는 지정되지 않은 대상 형식 값이 됩니다.

• double을 float로 변환할 경우 double 값을 가장 가까운 float 값으로 반올림합니다. double 값이 너무 크거나 작아서 float 형식에 맞지 않는 경우 결과 값은 0 또는 무한대가 됩니다.

• float 또는 double을 decimal로 변환할 경우 소스 값을 decimal 표현으로 변환한 다음 필요한 경우 가장 가까운 소수점 이하 28번째 자리로 반올림합니다. 소스 값에 따라 다음 결과 중 하나가 발생할 수 있습니다.

  • 소스 값이 너무 작아서 decimal로 나타낼 수 없을 경우 결과 값은 0이 됩니다.

  • 소스 값이 NaN(숫자가 아님), 무한대 또는 너무 커서 decimal로 나타낼 수 없을 경우 OverflowException을 throw합니다.

• decimal을 float 또는 double로 변환하는 경우 소스 값이 각각 가장 가까운 float 또는 double 값으로 반올림됩니다.

C# 언어 사양

자세한 내용은 C# 언어 사양의 다음 섹션을 참조하세요.

• 암시적 숫자 변환
• 명시적 숫자 변환

참고 항목

• 캐스팅 및 형식 변환