Namespaces
Variants

Numeric limits

From ko.cppreference.net
< c ‎ | types

목차

정수형의 특성

코어 언어 정수 타입의 특성
헤더에 정의됨 <limits.h>
BOOL_WIDTH
(C23)
비트 폭 bool
(매크로 상수)
CHAR_BIT
바이트의 비트 폭
(매크로 상수)
MB_LEN_MAX
멀티바이트 문자에서 최대 바이트 수
(매크로 상수)
CHAR_WIDTH
(C23)
비트 폭 char
(매크로 상수)
CHAR_MIN
최소값 char
(매크로 상수)
CHAR_MAX
최대값 char
(매크로 상수)
SCHAR_WIDTHSHRT_WIDTHINT_WIDTHLONG_WIDTHLLONG_WIDTH
(C23)(C23)(C23)(C23)(C23)
비트 폭 signed char, short, int, long, 및 long long 각각
(매크로 상수)
SCHAR_MINSHRT_MININT_MINLONG_MINLLONG_MIN
(C99)
최소값 signed char, short, int, long 및 long long 각각
(매크로 상수)
SCHAR_MAXSHRT_MAXINT_MAXLONG_MAXLLONG_MAX
(C99)
최대값 signed char, short, int, long 및 long long 각각
(매크로 상수)
UCHAR_WIDTHUSHRT_WIDTHUINT_WIDTHULONG_WIDTHULLONG_WIDTH
(C23)(C23)(C23)(C23)(C23)
비트 폭 unsigned char, unsigned short, unsigned int, unsigned long, 및 unsigned long long 각각
(매크로 상수)
UCHAR_MAXUSHRT_MAXUINT_MAXULONG_MAXULLONG_MAX
(C99)
최대값 unsigned char, unsigned short, unsigned int,
unsigned long 및 unsigned long long 각각
(매크로 상수)
BITINT_MAXWIDTH
(C23)
최대 폭 N 비트 정밀 정수의 선언에 의해 지원됨 (타입 지정자) _BitInt(N)
(매크로 상수)
라이브러리 타입 별칭의 특성
헤더 <stdint.h>
에 정의됨 PTRDIFF_WIDTH
(C23)
ptrdiff_t
의 비트 너비 (매크로 상수)
PTRDIFF_MIN
(C99)
ptrdiff_t
의 최솟값 (매크로 상수)
PTRDIFF_MAX
(C99)
ptrdiff_t
의 최댓값 (매크로 상수)
SIZE_WIDTH
(C23)
size_t
의 비트 너비 (매크로 상수)
SIZE_MAX
(C99)
size_t
의 최댓값 (매크로 상수)
SIG_ATOMIC_WIDTH
(C23)
sig_atomic_t
의 비트 너비 (매크로 상수)
SIG_ATOMIC_MIN
(C99)
sig_atomic_t
의 최솟값 (매크로 상수)
SIG_ATOMIC_MAX
(C99)
sig_atomic_t
의 최댓값 (매크로 상수)
WINT_WIDTH
(C23)
의 비트 너비 wint_t
(매크로 상수)
WINT_MIN
(C99)
의 최솟값 wint_t
(매크로 상수)
WINT_MAX
(C99)
의 최댓값 wint_t
(매크로 상수)
헤더 <wchar.h>
에 정의됨헤더 <stdint.h>
에 정의됨WCHAR_WIDTH
(C23)
의 비트 너비 wchar_t
(매크로 상수)
WCHAR_MIN
(C99)
의 최솟값 wchar_t
(매크로 상수)
WCHAR_MAX
(C99)
의 최댓값 wchar_t
(매크로 상수)

값 요구 사항

BOOL_WIDTH은 항상 1으로 확장됩니다.

(C23부터)

각각의 *_WIDTH매크로 (BOOL_WIDTH를 제외), BITINT_MAXWIDTH,(C23부터) CHAR_BIT 및 MB_LEN_MAX는 구현 정의 값으로 확장됩니다. 허용되는 최소값은 아래에 나열되어 있으며, /로 구분된 각 매크로 그룹은 항상 동일한 값으로 확장됩니다:

  • 최소 1: MB_LEN_MAX
  • 최소 8: CHAR_BIT / CHAR_WIDTH / SCHAR_WIDTH / UCHAR_WIDTH, WCHAR_WIDTH, SIG_ATOMIC_WIDTH
  • 최소 16: SHRT_WIDTH / USHRT_WIDTH, INT_WIDTH / UINT_WIDTH, PTRDIFF_WIDTH, SIZE_WIDTH, WINT_WIDTH
  • 최소 32: LONG_WIDTH / ULONG_WIDTH
  • 최소 64: LLONG_WIDTH / ULLONG_WIDTH
  • 최소 ULLONG_WIDTH: BITINT_MAXWIDTH

참고 사항

CHAR_BIT 와 MB_LEN_MAX 를 제외한 이러한 상수들의 타입은 정수 승격 이 해당 타입의 객체에 적용된 결과와 일치해야 합니다: CHAR_MAX 는 타입이 int 또는 unsigned int 일 수 있지만 절대 char 일 수 없습니다. 마찬가지로 USHRT_MAX 는 부호 없는 타입일 수 없습니다: 해당 타입은 int 일 수 있습니다.

독립형 구현에서는 sig_atomic_t 및/또는 wint_t typedef 이름이 없을 수 있으며, 이 경우 SIG_ATOMIC_* 및/또는 WINT_* 매크로가 해당하게 존재하지 않습니다.

예제

#include <limits.h>
#include <stdint.h>
#include <stdio.h>
int main(void)
{
    printf("CHAR_BIT       = %d\n", CHAR_BIT);
    printf("MB_LEN_MAX     = %d\n\n", MB_LEN_MAX);
    printf("CHAR_MIN       = %+d\n", CHAR_MIN);
    printf("CHAR_MAX       = %+d\n", CHAR_MAX);
    printf("SCHAR_MIN      = %+d\n", SCHAR_MIN);
    printf("SCHAR_MAX      = %+d\n", SCHAR_MAX);
    printf("UCHAR_MAX      = %u\n\n", UCHAR_MAX);
    printf("SHRT_MIN       = %+d\n", SHRT_MIN);
    printf("SHRT_MAX       = %+d\n", SHRT_MAX);
    printf("USHRT_MAX      = %u\n\n", USHRT_MAX);
    printf("INT_MIN        = %+d\n", INT_MIN);
    printf("INT_MAX        = %+d\n", INT_MAX);
    printf("UINT_MAX       = %u\n\n", UINT_MAX);
    printf("LONG_MIN       = %+ld\n", LONG_MIN);
    printf("LONG_MAX       = %+ld\n", LONG_MAX);
    printf("ULONG_MAX      = %lu\n\n", ULONG_MAX);
    printf("LLONG_MIN      = %+lld\n", LLONG_MIN);
    printf("LLONG_MAX      = %+lld\n", LLONG_MAX);
    printf("ULLONG_MAX     = %llu\n\n", ULLONG_MAX);
    printf("PTRDIFF_MIN    = %td\n", PTRDIFF_MIN);
    printf("PTRDIFF_MAX    = %+td\n", PTRDIFF_MAX);
    printf("SIZE_MAX       = %zu\n", SIZE_MAX);
    printf("SIG_ATOMIC_MIN = %+jd\n",(intmax_t)SIG_ATOMIC_MIN);
    printf("SIG_ATOMIC_MAX = %+jd\n",(intmax_t)SIG_ATOMIC_MAX);
    printf("WCHAR_MIN      = %+jd\n",(intmax_t)WCHAR_MIN);
    printf("WCHAR_MAX      = %+jd\n",(intmax_t)WCHAR_MAX);
    printf("WINT_MIN       = %jd\n", (intmax_t)WINT_MIN);
    printf("WINT_MAX       = %jd\n", (intmax_t)WINT_MAX);
}

가능한 출력:

CHAR_BIT       = 8
MB_LEN_MAX     = 16
CHAR_MIN       = -128
CHAR_MAX       = +127
SCHAR_MIN      = -128
SCHAR_MAX      = +127
UCHAR_MAX      = 255
SHRT_MIN       = -32768
SHRT_MAX       = +32767
USHRT_MAX      = 65535
INT_MIN        = -2147483648
INT_MAX        = +2147483647
UINT_MAX       = 4294967295
LONG_MIN       = -9223372036854775808
LONG_MAX       = +9223372036854775807
ULONG_MAX      = 18446744073709551615
LLONG_MIN      = -9223372036854775808
LLONG_MAX      = +9223372036854775807
ULLONG_MAX     = 18446744073709551615
PTRDIFF_MIN    = -9223372036854775808
PTRDIFF_MAX    = +9223372036854775807
SIZE_MAX       = 18446744073709551615
SIG_ATOMIC_MIN = -2147483648
SIG_ATOMIC_MAX = +2147483647
WCHAR_MIN      = -2147483648
WCHAR_MAX      = +2147483647
WINT_MIN       = 0
WINT_MAX       = 4294967295

부동소수점 타입의 특성 및 특수 값

부동 소수점 타입의 특성
헤더 <float.h>
부동 소수점 연산의 기본 반올림 모드
(매크로 상수)
모든 산술 연산이 수행되는 정밀도를 지정
(매크로 상수)
FLT_HAS_SUBNORMDBL_HAS_SUBNORMLDBL_HAS_SUBNORM
(C11)(C23에서 폐기됨)
타입이 비정규(denormal) 수를 지원하는지 여부를 지정:
-1 – 결정 불가, 0 – 없음, 1 – 있음
(매크로 상수)
FLT_RADIX
세 부동 소수점 타입의 표현에 사용되는 기수(정수 밑)
(매크로 상수)
FLT_MANT_DIGDBL_MANT_DIGLDBL_MANT_DIG
FLT_RADIX 밑 자릿수로, float, double 및 long double 각각에 대해 정밀도를 잃지 않고 표현할 수 있는 자릿수
(매크로 상수)
FLT_DECIMAL_DIGDBL_DECIMAL_DIGLDBL_DECIMAL_DIG
(C11)
float/double/long double에서 최소 FLT_DECIMAL_DIG/DBL_DECIMAL_DIG/LDBL_DECIMAL_DIG 자릿수의 십진수로 변환했다가 되돌리는 것이 항등 변환: 부동 소수점 값을 직렬화/역직렬화하는 데 필요한 십진 정밀도
(매크로 상수)
DECIMAL_DIG
(C99)(C23에서 폐기됨)
long double에서 최소 DECIMAL_DIG 자릿수의 십진수로 변환했다가 long double로 되돌리는 것이 항등 변환: long double
를 직렬화/역직렬화하는 데 필요한 십진 정밀도(매크로 상수)
FLT_DIGDBL_DIGLDBL_DIG
텍스트 → float/double/long double → 텍스트 왕복 시 반올림이나 오버플로로 인한 변경 없이 보존이 보장되는 십진 자릿수
(매크로 상수)
FLT_MIN_EXPDBL_MIN_EXPLDBL_MIN_EXP
FLT_RADIX의 지수가 해당 정수보다 1 작은 값일 때 float, double 및 long double 각각에 대해 정규화된 값을 만드는 최소 음의 정수
(매크로 상수)
FLT_MIN_10_EXPDBL_MIN_10_EXPLDBL_MIN_10_EXP
10의 지수가 해당 정수일 때 float, double 및 long double 각각에 대해 정규화된 값을 만드는 최소 음의 정수
(매크로 상수)
FLT_MAX_EXPDBL_MAX_EXPLDBL_MAX_EXP
FLT_RADIX의 지수가 해당 정수보다 1 작은 값일 때 float, double 및 long double 각각에 대해 표현 가능한 유한 값을 만드는 최대 양의 정수
(매크로 상수)
FLT_MAX_10_EXPDBL_MAX_10_EXPLDBL_MAX_10_EXP
10의 지수가 해당 정수일 때 float, double 및 long double 각각에 대해 표현 가능한 유한 값을 만드는 최대 양의 정수
(매크로 상수)
FLT_MAXDBL_MAXLDBL_MAX
float, double 및 long double 각각의 최대 유한 값
(매크로 상수)
FLT_EPSILONDBL_EPSILONLDBL_EPSILON
1.0과 그 다음 표현 가능한 값의 차이 (float, double 및 long double 각각)
(매크로 상수)
FLT_MINDBL_MINLDBL_MIN
float, double 및 long double 각각의 최소 정규화된 양수 값
(매크로 상수)
FLT_TRUE_MINDBL_TRUE_MINLDBL_TRUE_MIN
(C11)
float, double 및 long double 각각의 최소 양수 값
(매크로 상수)
부동 소수점 타입의 특수 값
헤더에 정의됨 <math.h>    (C23에서 폐지됨)
헤더에 정의됨 <float.h>  (C23부터)
(존재하는 경우) 양의 무한대로 평가됨
(매크로 상수)
(C99)
(존재하는 경우) float 타입의 quiet NaN으로 평가됨
(매크로 상수)
헤더에 정의됨 <float.h>
(존재하는 경우) 각각 float, double, long double의 signaling NaN으로 평가됨
(매크로 상수)

예제

#include <float.h>
#include <math.h>
#include <stdio.h>

int main(void)
{
    printf("DECIMAL_DIG     = %d\n", DECIMAL_DIG);
    printf("FLT_DECIMAL_DIG = %d\n", FLT_DECIMAL_DIG);
    printf("FLT_RADIX       = %d\n", FLT_RADIX);
    printf("FLT_MIN         = %e\n", FLT_MIN);
    printf("FLT_MAX         = %e\n", FLT_MAX);
    printf("FLT_EPSILON     = %e\n", FLT_EPSILON);
    printf("FLT_DIG         = %d\n", FLT_DIG);
    printf("FLT_MANT_DIG    = %d\n", FLT_MANT_DIG);
    printf("FLT_MIN_EXP     = %d\n", FLT_MIN_EXP);
    printf("FLT_MIN_10_EXP  = %d\n", FLT_MIN_10_EXP);
    printf("FLT_MAX_EXP     = %d\n", FLT_MAX_EXP);
    printf("FLT_MAX_10_EXP  = %d\n", FLT_MAX_10_EXP);
    printf("FLT_ROUNDS      = %d\n", FLT_ROUNDS);
    printf("FLT_EVAL_METHOD = %d\n", FLT_EVAL_METHOD);
    printf("FLT_HAS_SUBNORM = %d\n", FLT_HAS_SUBNORM);
}

가능한 출력:

DECIMAL_DIG     = 37
FLT_DECIMAL_DIG = 9
FLT_RADIX       = 2
FLT_MIN         = 1.175494e-38
FLT_MAX         = 3.402823e+38
FLT_EPSILON     = 1.192093e-07
FLT_DIG         = 6
FLT_MANT_DIG    = 24
FLT_MIN_EXP     = -125
FLT_MIN_10_EXP  = -37
FLT_MAX_EXP     = 128
FLT_MAX_10_EXP  = 38
FLT_ROUNDS      = 1
FLT_EVAL_METHOD = 1
FLT_HAS_SUBNORM = 1

참고문헌

  • C23 표준 (ISO/IEC 9899:2024):
  • 5.2.4.2 수치 한계 (p: TBD)
  • 7.22.3 다른 정수형의 한계 (p: TBD)
  • C17 표준 (ISO/IEC 9899:2018):
  • 5.2.4.2 수치 한계 (p: 20-27)
  • 7.20.3 다른 정수형의 한계 (p: 215-216)
  • C11 표준 (ISO/IEC 9899:2011):
  • 5.2.4.2 수치 한계 (p: 26-34)
  • 7.20.3 다른 정수형의 한계 (p: 293-294)
  • C99 표준 (ISO/IEC 9899:1999):
  • 5.2.4.2 수치 한계 (p: 21-28)
  • 7.18.3 다른 정수형의 한계 (p: 259-260)
  • C89/C90 표준 (ISO/IEC 9899:1990):
  • 2.2.4.2 수치적 한계

참고 항목

C++ documentation for C numeric limits interface