定宽整数类型 (C++11 起)

類型

實現可在 N 不是 8、 16、 32 或 64 時定義 typedef 名 intN_t、int_fastN_t、int_leastN_t、uintN_t、uint_fastN_t 及 uint_leastN_t。形為 intN_t 的 typedef 名只有在實現支持有該寬度而無填充的整數類型才可以定義。從而 std::uint24_t 代表寬度正好是 24 位的無符號整數類型。

下面列出的每個宏當且僅當實現定義了對應的 typedef 名時才得以定義。宏 INTN_C 與 UINTN_C 分別對應 typedef 名 int_leastN_t 與 uint_leastN_t。

宏常量

最小寬度整數常量的函數宏

#include <cstdint>
UINT64_C(0x123) // 展开成类型为 uint64_t 而值为 0x123 的字面量

格式宏常量

std::fprintf 系列函數的格式宏常量

此處列出的每個 PRI 宏當且僅當實現定義了對應的 typedef 名時才得以定義。

std::fscanf 系列函數的格式宏常量

此處列出的每個 SCN 宏當且僅當實現定義了對應的 typedef 名且擁有適合該類型的 std::fscanf 長度修飾符時才得以定義。

註解

因為 C++ 會將後面緊跟一個字符的字符串字面量判讀為用戶定義字面量，所以諸如 printf("%"PRId64"\n",n); 這樣的 C 代碼在 C++ 中非法，並要求 PRId64 前要有空格。

C99 標準建議 C++ 實現不應定義上述極限、常量或格式化宏，除非在包含相對的 C 標頭（stdint.h 或 inttypes.h）前（分別）定義了宏 __STDC_LIMIT_MACROS、__STDC_CONSTANT_MACROS 或 __STDC_FORMAT_MACROS。此建議未被任何 C++ 標準採納，並在 C11 中被移除。然而，某些實現（例如 glibc 2.17）嘗試應用此規則，而可能需要定義 __STDC 宏；C++ 編譯器可以通過在某些環境中自動定義它們來做變通。

std::int8_t 可以是 signed char，std::uint8_t 也可以是 unsigned char，但兩者都不能是 char（因為 char 既不視為「有符號整數類型」也不視為「無符號整數類型」）。

示例

#include <cinttypes>
#include <cstdio>

int main()
{
    std::printf("%zu\n", sizeof(std::int64_t));
    std::printf("%s\n", PRId64);
    std::printf("%+" PRId64 "\n", INT64_MIN);
    std::printf("%+" PRId64 "\n", INT64_MAX);
    
    std::int64_t n = 7;
    std::printf("%+" PRId64 "\n", n);
}

8
lld
-9223372036854775808
+9223372036854775807
+7

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

引用

參閱

• 基礎類型