跨平台整數類型： 固定寬度類型與格式化輸出最佳實踐

跨平台整數類型： 固定寬度類型與格式化輸出最佳實踐

C 語言基本整數類型（int、long 等）長度隨實現定義，導致跨平台移植時數據截斷、格式化字符串不匹配等隱患。C99 引入 <stdint.h> 定義固定寬度類型，配合 <inttypes.h> 宏實現可移植格式化輸出。本文系統講解類型分類、跨平台打印方案、實戰案例（Muduo 庫）。

一、固定寬度整數類型分類

建議：優先使用 int32_t/int64_t 等精確寬度類型作為接口、協議、存儲定義；內部計算可用 int_fast32_t 提速。

二、跨平台格式化輸出：PRId32 / PRId64 宏

問題：int64_t 在 32 位系統是 long long（%lld），64 位系統是 long（%ld）。直接寫死格式化字符串會導致編譯警告或運行時錯誤。

解決方案：使用 <inttypes.h> 提供的宏，預處理器自動展開為正確格式。

#include <inttypes.h>
#include <stdint.h>

int64_t val = 123456789012345LL;
printf("Value: %" PRId64 "\n", val);  // 自動展開為 %ld 或 %lld

// C++ 需顯式定義宏開關（C99 標準要求）
#ifndef __STDC_FORMAT_MACROS
#define __STDC_FORMAT_MACROS
#endif
#include <inttypes.h>

三、常用格式宏速查

十六進制：PRIx32、PRIx64（小寫）、PRIX32（大寫）。

四、實戰案例：Muduo 庫 Timestamp 實現

// muduo/base/Timestamp.cc
#include <muduo/base/Timestamp.h>
#include <sys/time.h>
#include <stdio.h>
#ifndef __STDC_FORMAT_MACROS
#define __STDC_FORMAT_MACROS
#endif
#include <inttypes.h>
#include <boost/static_assert.hpp>

using namespace muduo;
BOOST_STATIC_ASSERT(sizeof(Timestamp) == sizeof(int64_t));

Timestamp::Timestamp(int64_t microseconds)
    : microSecondsSinceEpoch_(microseconds) {}

string Timestamp::toString() const {
    char buf[32] = {0};
    int64_t seconds = microSecondsSinceEpoch_ / kMicroSecondsPerSecond;
    int64_t microseconds = microSecondsSinceEpoch_ % kMicroSecondsPerSecond;
    snprintf(buf, sizeof(buf)-1, "%" PRId64 ".%06" PRId64 "", seconds, microseconds);
    return buf;
}

Timestamp Timestamp::now() {
    struct timeval tv;
    gettimeofday(&tv, NULL);
    int64_t seconds = tv.tv_sec;
    return Timestamp(seconds * kMicroSecondsPerSecond + tv.tv_usec);
}

關鍵點：static_assert 保證類型大小；PRId64 確保跨平台打印正確；snprintf 防止緩衝區溢出。

五、C++11 及以上編譯器簡化

支持 C++11 的編譯器（GCC 4.7+、Clang 3.1+、MSVC 2013+）無需定義 __STDC_FORMAT_MACROS，直接包含 <cinttypes> 即可使用宏。

#include <cinttypes>  // C++ 風格頭文件
#include <cstdint>
int64_t val = 42;
printf("%" PRId64 "\n", val);  // 直接可用

六、避坑指南

1. 不要假設 long 是 64 位：Windows 64 位下 long 仍為 32 位（LLP64），Linux 64 位為 64 位（LP64）。
2. 網絡協議/文件格式/跨進程通信：強制使用 int32_t/int64_t + PRId32/PRId64。
3. scanf 族函數：同理使用 SCNd64 等宏，避免 %lld 在 32 位系統讀取 int64_t 錯誤。
4. 結構體對齊：固定寬度類型不改變對齊規則，跨平台傳輸仍需打包（#pragma pack 或手動序列化）。

拥抱 <stdint.h> + <inttypes.h>，是編寫可移植、可維護、專業級 C/C++ 代碼的標誌性習慣。