C++十进制转十六进制方法详解

最快输出十六进制应使用 std::hex 与 std::ostringstream，C++ 标准库提供安全、可读、支持大小写的格式化方案；常见错误包括误用 printf 忽略符号位或前导零，或直接用 std::cout 不加控制。

用 std::hex 和 std::ostringstream 最快输出十六进制

不需要手写转换逻辑，C++ 标准库已提供稳定、可读、支持大小写的格式化方案。关键不是“怎么转”，而是“怎么安全地转成字符串或控制台输出”。

常见错误是直接用 printf("%x", n) 忽略符号位或前导零，或者用 std::cout << std::hex << n 后忘记恢复十进制状态，导致后续输出全乱。

• std::ostringstream 隔离格式状态，避免污染全局流
• 加 std::uppercase 控制 A-F 大写，std::setfill('0') + std::setw(2) 补零（注意：setw 只对下一次输出生效）
• 负数默认按补码输出（如 -1 → ffffffff），若需无符号解释，必须先强转：static_cast(n)

std::ostringstream oss;
oss << std::hex << std::uppercase << std::setfill('0') << std::setw(4) 
    << static_cast(255); // 输出 "00FF"

手动实现转换时，为什么不能用除 16 取余直接拼字符串？

因为除法取余得到的是逆序数字，且没处理 10–15 对应的 A–F 字符；更隐蔽的问题是：对 0 的边界处理、负数未定义行为、以及越界整数在取模时可能为负（如 -1 % 16 在某些编译器返回 -1）。

• 务必先转为无符号类型再运算，例如 unsigned int u = static_cast(n)
• 用查表法比条件判断更简洁安全：const char digits[] = "0123456789ABCDEF"
• 结果字符串要 reverse，或从缓冲区末尾向前写（推荐后者，避免额外翻转开销）

std::string to_hex(int n) {
    if (n == 0) return "0";
    unsigned int u = static_cast(n);
    char buf[9] = {}; // 32 位最多 8 字符 + '\0'
    char* p = buf + sizeof(buf) - 1;
    *p = '\0';
    do {
        *--p = "0123456789ABCDEF"[u % 16];
        u /= 16;
    } while (u != 0);
    return std::string(p);
}

sprintf / snprintf 要小心缓冲区和符号扩展

用 C 风格函数看似简单，但 sprintf(buf, "%x", n) 对负数行为未定义；%x 期望 unsigned int，传入 int 会触发整型提升，但符号位可能被错误解释。

• 永远用 snprintf 替代 sprintf，防止栈溢出
• 显式转无符号：snprintf(buf, sizeof(buf), "%x", static_cast(n))
• 如果需要固定宽度且大写，用 "%04X" —— 注意 0 是填充符，4 是最小宽度，X 是大写十六进制

不同整数宽度（uint8_t、uint64_t）影响输出长度和补零逻辑

不是所有场景都适合统一用 int。比如处理网络字节流或二进制协议时，你明确知道输入是 uint8_t，那就不该用 int 接收再转——不仅语义不清，还可能因隐式提升引入高位垃圾值（尤其在小端机器上读错字节）。

• 对 uint8_t，用 "%02x"；对 uint16_t，用 "%04x"；对 uint64_t，需搭配 PRIx64 宏（来自 <inttypes.h>）
• 使用 std::format（C++20）可类型安全地处理宽整数：std::format("{:02x}", u8_value)
• 手动转换函数若模板化，必须约束为无符号整型，否则 static_cast<U>(n) 对负数仍是未定义

实际中最容易被忽略的，是“输入值是否真的代表一个待编码的非负数值”。很多 bug 来自把状态码、标志位、内存地址这些本就该当无符号看待的东西，用有符号类型读取后再转十六进制——此时不加 static_cast 就直接掉坑里。