std::format需显式指定进制(b/o/x/x)和精度(.nf/g/e),#添加前缀,浮点不支持进制转换;宽度与精度组合须严格匹配类型,自定义类型需手动解析转发格式说明符。

std::format 默认不控制进制和精度,必须显式写 {:x}、{:.2f} 这类格式说明符,否则输出行为由类型和值决定,不是“没生效”,而是根本没启用对应规则。
如何用 std::format 输出十六进制、八进制、二进制
整数支持 b、o、x(小写)或 X(大写)类型说明符,不加类型时默认十进制;# 标志可添加前缀:
-
std::format("{:x}", 255)→"ff" -
std::format("{:#x}", 255)→"0xff" -
std::format("{:X}", 255)→"FF" -
std::format("{:#X}", 255)→"0XFF" -
std::format("{:b}", 12)→"1100",{:#b}→"0b1100" -
std::format("{:o}", 64)→"100",{:#o}→"0100"(注意:八进制前缀是0,不是0o)
⚠️ 浮点数不支持 b/o/x;传入浮点数却用 {:x} 会编译失败(SFINAE 拒绝),不是运行时报错。
{:.Nf}、{:.Ng}、{:.Ne} 的精度含义完全不同
三者控制的是三种互斥的数字表达模型,混用或误选会导致输出严重偏离预期:
-
{:.3f}:强制定点格式,小数点后**恰好 3 位**,不足补零(1.2→"1.200");适合 UI 显示、金额、坐标等要求小数位数严格一致的场景 -
{:.3g}:最多 **3 个有效数字**,自动在f和e间切换(0.001234→"0.00123",123456→"1.23e+05");适合传感器读数、工程报告等宽动态范围数据 -
{:.3e}:强制科学计数法,小数点后**恰好 3 位**(123.456→"1.235e+02");适合调试浮点内部表示或对齐指数位
⚠️ {:.0f} 是截断(truncation),不是四舍五入:3.9 → "3";如需四舍五入再格式化,得先调用 std::round。
宽度与精度组合时的常见失效点
宽度(如 10)和精度(如 .2f)能共存,但顺序和类型约束极强,稍错就导致行为失控:
-
{:10.2f}合法:总宽 ≥10,右对齐,小数点后 2 位,空格填充 -
{:010.2f}合法:同上,但空格换为'0'填充(注意:仅对数值格式如f/e有效) -
{:*^12.2f}合法:居中、宽 12、小数点后 2 位、'*'填充 -
{:>10}对double不可靠:未指定f或g,实际可能输出"1.23457e+08",宽度完全失效
⚠️ 带宽度的格式化会触发额外字符串缓冲区分配;高频日志中避免无意义的大宽度(如 {:50.2f})——它不压缩内容,只撑宽输出。
自定义类型里嵌套数值格式要手动转发
为自定义类型特化 std::formatter 时,若内部字段需按用户指定精度/进制输出(如 Point{15, 255} 要支持 "(0xf, 0xff)"),不能靠 std::format_to 直接传 "{:x}" 字符串,而必须解析并转发格式说明符:
-
parse()中需提取x、o、.2f等子串,并保存为成员变量 -
format()中根据保存的说明符,分别调用std::format_to(ctx.out(), "{:x}", p.x)或std::format_to(ctx.out(), "{:.2f}", p.y) - 忽略
parse()或硬编码格式(如固定用"{}")会导致std::format("{}", p)和std::format("{:x}", p)输出完全一样
最常被忽略的是:格式说明符解析逻辑缺失,导致用户写的 {:08x} 在自定义类型里毫无作用——它不会自动透传给内部字段。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











