Fixed width integer types (since C++11) (original) (raw)

Contents

[edit] Types

Defined in header
int8_tint16_tint32_tint64_t(optional) signed integer type with width of exactly 8, 16, 32 and 64 bits respectivelywith no padding bits and using 2's complement for negative values(provided if and only if the implementation directly supports the type) (typedef) [edit]
int_fast8_tint_fast16_tint_fast32_tint_fast64_t fastest signed integer type with width of at least 8, 16, 32 and 64 bits respectively (typedef) [edit]
int_least8_tint_least16_tint_least32_tint_least64_t smallest signed integer type with width of at least 8, 16, 32 and 64 bits respectively (typedef) [edit]
intmax_t maximum-width signed integer type (typedef) [edit]
intptr_t(optional) signed integer type capable of holding a pointer to void (typedef) [edit]
uint8_tuint16_tuint32_tuint64_t(optional) unsigned integer type with width of exactly 8, 16, 32 and 64 bits respectively (provided if and only if the implementation directly supports the type) (typedef) [edit]
uint_fast8_tuint_fast16_tuint_fast32_tuint_fast64_t fastest unsigned integer type with width of at least 8, 16, 32 and 64 bits respectively (typedef) [edit]
uint_least8_tuint_least16_tuint_least32_tuint_least64_t smallest unsigned integer type with width of at least 8, 16, 32 and 64 bits respectively (typedef) [edit]
uintmax_t maximum-width unsigned integer type (typedef) [edit]
uintptr_t(optional) unsigned integer type capable of holding a pointer to void (typedef) [edit]

The implementation may define typedef names int_N__t, int_fast_N__t, int_least_N__t, uint_N__t, uint_fast_N__t, and uint_least_N__t when N is not 8, 16, 32 or 64. Typedef names of the form int_N__t may only be defined if the implementation supports an integer type of that width with no padding. Thus, std::uint24_t denotes an unsigned integer type with a width of exactly 24 bits.

Each of the macros listed in below is defined if and only if the implementation defines the corresponding typedef name. The macros INT_N__C and UINT_N__C correspond to the typedef names int_least_N__t and uint_least_N__t, respectively.

[edit] Macro constants

Defined in header
Signed integers : minimum value
INT8_MININT16_MININT32_MININT64_MIN(optional) minimum value of std::int8_t, std::int16_t, std::int32_t and std::int64_t respectively (macro constant) [edit]
INT_FAST8_MININT_FAST16_MININT_FAST32_MININT_FAST64_MIN minimum value of std::int_fast8_t, std::int_fast16_t, std::int_fast32_t and std::int_fast64_t respectively (macro constant) [edit]
INT_LEAST8_MININT_LEAST16_MININT_LEAST32_MININT_LEAST64_MIN minimum value of std::int_least8_t, std::int_least16_t, std::int_least32_t and std::int_least64_t respectively (macro constant) [edit]
INTPTR_MIN(optional) minimum value of std::intptr_t (macro constant) [edit]
INTMAX_MIN minimum value of std::intmax_t (macro constant) [edit]
Signed integers : maximum value
INT8_MAXINT16_MAXINT32_MAXINT64_MAX(optional) maximum value of std::int8_t, std::int16_t, std::int32_t and std::int64_t respectively (macro constant) [edit]
INT_FAST8_MAXINT_FAST16_MAXINT_FAST32_MAXINT_FAST64_MAX maximum value of std::int_fast8_t, std::int_fast16_t, std::int_fast32_t and std::int_fast64_t respectively (macro constant) [edit]
INT_LEAST8_MAXINT_LEAST16_MAXINT_LEAST32_MAXINT_LEAST64_MAX maximum value of std::int_least8_t, std::int_least16_t, std::int_least32_t and std::int_least64_t respectively (macro constant) [edit]
INTPTR_MAX(optional) maximum value of std::intptr_t (macro constant) [edit]
INTMAX_MAX maximum value of std::intmax_t (macro constant) [edit]
Unsigned integers : maximum value
UINT8_MAXUINT16_MAXUINT32_MAXUINT64_MAX(optional) maximum value of std::uint8_t, std::uint16_t, std::uint32_t and std::uint64_t respectively (macro constant) [edit]
UINT_FAST8_MAXUINT_FAST16_MAXUINT_FAST32_MAXUINT_FAST64_MAX maximum value of std::uint_fast8_t, std::uint_fast16_t, std::uint_fast32_t and std::uint_fast64_t respectively (macro constant) [edit]
UINT_LEAST8_MAXUINT_LEAST16_MAXUINT_LEAST32_MAXUINT_LEAST64_MAX maximum value of std::uint_least8_t, std::uint_least16_t, std::uint_least32_t and std::uint_least64_t respectively (macro constant) [edit]
UINTPTR_MAX(optional) maximum value of std::uintptr_t (macro constant) [edit]
UINTMAX_MAX maximum value of std::uintmax_t (macro constant) [edit]

[edit] Function macros for minimum-width integer constants

INT8_CINT16_CINT32_CINT64_C expands to an integer constant expression having the value specified by its argument and whose type is the promoted type of std::int_least8_t, std::int_least16_t, std::int_least32_t and std::int_least64_t respectively (function macro) [edit]
expands to an integer constant expression having the value specified by its argument and the type std::intmax_t (function macro) [edit]
UINT8_CUINT16_CUINT32_CUINT64_C expands to an integer constant expression having the value specified by its argument and whose type is the promoted type of std::uint_least8_t, std::uint_least16_t, std::uint_least32_t and std::uint_least64_t respectively (function macro) [edit]
expands to an integer constant expression having the value specified by its argument and the type std::uintmax_t (function macro) [edit]

#include UINT64_C(0x123) // expands to a literal of type uint_least64_t and value 0x123

[edit] Format macro constants

[edit] Format constants for the std::fprintf family of functions

Each of the PRI macros listed here is defined if and only if the implementation defines the corresponding typedef name.

Equivalentfor int orunsigned int Description Macros for data types
std::intx_t std::int_leastx_t std::int_fastx_t std::intmax_t std::intptr_t
d output of a signed decimal integer value PRIdx PRIdLEASTx PRIdFASTx PRIdMAX PRIdPTR
i PRIix PRIiLEASTx PRIiFASTx PRIiMAX PRIiPTR
u output of an unsigned decimal integer value PRIux PRIuLEASTx PRIuFASTx PRIuMAX PRIuPTR
o output of an unsigned octal integer value PRIox PRIoLEASTx PRIoFASTx PRIoMAX PRIoPTR
x output of an unsigned lowercase hexadecimal integer value PRIxx PRIxLEASTx PRIxFASTx PRIxMAX PRIxPTR
X output of an unsigned uppercase hexadecimal integer value PRIXx PRIXLEASTx PRIXFASTx PRIXMAX PRIXPTR

[edit] Format constants for the std::fscanf family of functions

Each of the SCN macros listed in here is defined if and only if the implementation defines the corresponding typedef name and has a suitable std::fscanf length modifier for the type.

Equivalentfor int orunsigned int Description Macros for data types
std::intx_t std::int_leastx_t std::int_fastx_t std::intmax_t std::intptr_t
d input of a signed decimal integer value SCNdx SCNdLEASTx SCNdFASTx SCNdMAX SCNdPTR
i input of a signed integer value SCNix SCNiLEASTx SCNiFASTx SCNiMAX SCNiPTR
u input of an unsigned decimal integer value SCNux SCNuLEASTx SCNuFASTx SCNuMAX SCNuPTR
o input of an unsigned octal integer value SCNox SCNoLEASTx SCNoFASTx SCNoMAX SCNoPTR
x input of an unsigned hexadecimal integer value SCNxx SCNxLEASTx SCNxFASTx SCNxMAX SCNxPTR

[edit] Notes

Because C++ interprets a character immediately following a string literal as a user-defined string literal, C code such as printf("%"PRId64"\n",n); is invalid C++ and requires a space before PRId64.

The C99 standard suggests that C++ implementations should not define the above limit, constant, or format macros unless the macros __STDC_LIMIT_MACROS, __STDC_CONSTANT_MACROS or __STDC_FORMAT_MACROS (respectively) are defined before including the relevant C header (stdint.h or inttypes.h). This recommendation was not adopted by any C++ standard and was removed in C11. However, some implementations (such as glibc 2.17) try to apply this rule, and it may be necessary to define the __STDC macros; C++ compilers may try to work around this by automatically defining them in some circumstances.

std::int8_t may be signed char and std::uint8_t may be unsigned char, but neither can be char regardless of its signedness (because char is not considered a "signed integer type" or "unsigned integer type").

[edit] Example

See also a note regarding spaces before format macros used in this example.

Possible output:

8 lld -9223372036854775808 +9223372036854775807 +7

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR Applied to Behavior as published Correct behavior
LWG 2820 C++11 the requirements for optional typedef names and macros were inconsistent with C made consistent

[edit] References

[edit] See also