github fmt库语法+范例（fmt version :7.0.1)

！！版权声明：本文为博主原创文章，版权归原文作者和博客园共有，谢绝任何形式的 转载！！
作者：mohist

fmt

• fmt 源码： https://github.com/fmtlib/fmt
• 本文翻译：https://fmt.dev/latest/syntax.html
• fmt版本：7.0.1
• 本文仅为参考，请以官方文档为准。
• 水平有限，欢迎指正。有兴趣，参阅 官方文档。
• 本文仅为参考，请以 实际情况 为准。

正文

本文将介绍 fmt::format()和fmt::print()之类的格式化函数使用

A、格式化字符串有占位符，用大括号 {}表示占位，格式化字符串放在{}中间。没有放在{}之间的字符串被视为字符串输出。 如果需要输出的字符串中有大括号{}，可以额外增加一个大括号来实现。例如：{ { 和 } }

B、占位符语法如下：

replacement_field	:: = "{"[arg_id][":" format_spec] "}"
arg_id	:: = integer | identifier
integer	:: = digit +
digit	:: = "0"..."9"
identifier	:: = id_start id_continue*
id_start	:: = "a"..."z" | "A"..."Z" | "_"
id_continue	:: = id_start | digit

1、替换字段可用以 arg_id 开头，该参数指定要格式化其值并将其插入输出的参数，而不是替换字段。可选的arg_id放在format_spec的后面，其后是冒号'：'。这些指定替换值的非默认格式。

2、如果格式字符串中的数字arg_ids依次为0、1、2，...，则可以全部省略（不只是某些数字），数字0、1、2，...将按此顺序自动插入。

3、命名参数可以通过其名称或索引来引用。例如：

"First, thou shalt count to {0}"	// 替换第一个参数
"Bring me a {}"  	 // 隐式引用第一个参数
"From {} to {}" 	// 这行代码和 "From {0} to {1}"功效相同

4、format_spec 字段包含有关如何显示值的规范，包括字段宽度，对齐方式，填充，小数精度等详细信息。每种值类型都可以定义自己的“formatting mini - language”或对format_spec的解释。

5、大多数内置类型都支持通用的formatting mini - language，这将在下一节中进行介绍。

6、format_spec字段还可以在其中的某些位置包含嵌套的替换字段。这些嵌套的替换字段只能包含一个参数id。格式规格是不允许的。这将允许动态指定值的格式。

C、Mini - Language的格式规范

1、在格式字符串中包含的替换字段中使用“格式规范”来定义如何显示单个值。每种格式表类型可以定义如何解释格式规范。

2、 尽管某些格式化选项仅受数字类型支持，但大多数内置类型都为格式规范实现了以下选项。

3、标准格式说明符的一般形式为：

format_spec	:: = [[fill]align][sign]["#"]["0"][width]["." precision][type]
fill	:: = <a character other than '{' or '}'>
align	:: = "<" | ">" | "^"
sign	:: = "+" | "-" | " "
width	:: = integer | "{"[arg_id] "}"
precision	:: = integer | "{"[arg_id] "}"
type	:: = int_type | "a" | "A" | "c" | "e" | "E" | "f" | "F" | "g" | "G" | "L" | "p" | "s"
int_type	:: = "b" | "B" | "d" | "o" | "x" | "X"

4、填充字符可以是'{'或'}'以外的任何Unicode代码点。填充字符的存在由其后的字符表示，该字符必须是对齐选项之一。如果format_spec的第二个字符不是有效的对齐选项，则假定填充字符和对齐选项都不存在。

5、各种对齐选项的含义如下：
Option Meaning
'<' 强制字段在可用空间内左对齐(（大多数对象的默认设置).
'>' 强制字段在可用空间内右对齐(这是数字的默认设置).
'^' 强制字段在可用空间内居中.

6、请注意，除非定义了最小字段宽度，否则字段宽度将始终与填充它的数据大小相同。因此在这种情况下，对齐选项没有任何意义。

7、符号选项仅对数字类型有效，并且可以是以下之一:

Option Meaning
'+' 表示正负数均应使用符号，例如： + 5， - 2。
'-' 表示符号只能用于负数（负数默认设置显示）。
space 表示应在正数上使用前导空格，在负数上使用减号。

8、“＃”选项使“替代形式”用于转换。替代形式对于不同类型的定义不同。此选项仅对整数和浮点类型有效。对于整数，使用二进制，八进制或十六进制输出时，此选项将前缀“ 0b”（“ 0B”），“ 0”或“ 0x”（“ 0X”）添加到输出值。前缀是小写还是大写取决于类型说明符的大小写，例如，前缀“ 0x”用于类型“ x”，“ 0X”用于“ X”。对于浮点数，替代格式会导致转换结果始终包含小数点字符，即使后面没有数字也是如此。通常，只有在数字后面跟随小数点字符，这些转换的结果才会出现。另外，对于“ g”和“ G”转换，不会从结果中删除部零。

9、width是定义最小字段宽度的十进制整数。如果未指定，则字段宽度将由内容确定。

10、在宽度字段前面加上零（'0'），字符可启用数字类型的符号识别0填充.它强制将填充内容放置在符号或基数（如果有）之后但在数字之前。这用于以“ + 000000120”形式打印字段。此选项仅对数字类型有效，并且对无穷大和NaN的格式无效。

11、precision是一个十进制数字，表示以'f'和'F'格式设置的浮点值在小数点后应显示多少位数，用'g'或'G'格式化的浮点值小数点前后。对于非数字类型，该字段指示最大字段大小，换句话说，字段内容中将使用多少个字符。整数，字符，布尔值和指针值不允许使用精度。

12、type字段决定了应如何显示数据。

13、可用的字符串表示类型为：
Type　　 Meaning
's' 字符串格式。字符串的默认类型，可以省略
none 与's'相同

14、可用的字符显示类型为：
Type Meaning
'c' 字符格式。字符的默认类型，可以省略。
none 与'c'相同

15、可用的整数表示类型为：

Type	Meaning
'b'	二进制格式。输出以2为进制的数字。在此类型中使用'＃'选项，会将前缀“ 0b”添加到输出值中。value.
'B'	二进制格式。输出以2为进制的数字。对此类型使用'＃'选项，可在输出值中添加前缀“ 0B”。
'd'	十进制整数。输出以10为进制的数字。
'0'	八进制格式。输出以8为进制的数字。
'x'	十六进制格式。输出以16为进制的数字，对9以上的数字使用小写字母。将'＃'选项与该类型一起使用时，会将前缀“ 0x”添加到输出值中。
'X'	十六进制格式。输出以16为进制的数字，对9以上的数字使用大写字母。将'＃'选项与该类型一起使用时，会将前缀“ 0X”添加到输出值中。
'L'	特定于语言环境的格式。这与'd'相同，除了它使用当前的语言环境设置来插入适当的数字分隔符。
none	与 'd' 相同

16、整数表示类型也可以与字符和布尔值一起使用。如果未指定输出类型，布尔值使用文本表示形式设置为true或false，

17、浮点值的可用显示类型为：

Type Meaning
'a' 十六进制浮点格式。打印以16为底的数字，前缀为“ 0x”，小写字母表示9以上的数字。使用'p'表示指数。
'A' 与 'a' 相同，不同之处在于它使用大写字母作为前缀，数字大于9并表示指数。
'e' 指数表示法。使用字母“ e”以科学计数法打印数字以表示指数。
'E' 指数表示法。与'e'相同，除了它使用大写字母'E'作为分隔符。
'f' 固定点。将数字显示为定点数字。
'F' 固定点。与'f'相同，但是将nan转换为NAN，将inf转换为INF。
'g' 通用格式。对于给定的精度p > = 1，这会将数字四舍五入为p个有效数字，然后根据结果的大小以定点格式或科学计数法格式化结果。精度0等同于精度1。
'G' 通用格式。与“ g”相同，但如果数字太大则切换到 'E'。无限大和NaN的表示也都是大写的。
'L' 特定于语言环境的格式。这与'g'相同，只是它使用当前的语言环境设置来插入适当的数字分隔符。
none 与“'g'相似，不同之处在于定点表示法在使用时，其小数点后至少有一位数字。默认精度与表示特定值所需的精度一样高。

18、指针的可用显示类型为:

Type Meaning
'p' 指针格式。这是指针的默认类型，可以省略。
none 与 'p'相同

D、格式范例

本节包含格式语法的示例以及与printf格式的比较。

1、大多数情况下，语法类似于printf格式，加上{} 和 ：代替％。例如，“％03.2f”可以转换为“{ ：03.2f }”。

2、新格式的语法还支持新的和不同的选项，如以下示例所示。

2.1、按位置访问参数：

fmt::format("{0}, {1}, {2}", 'a', 'b', 'c');
// Result: "a, b, c"
fmt::format("{}, {}, {}", 'a', 'b', 'c');
// Result: "a, b, c"
fmt::format("{2}, {1}, {0}", 'a', 'b', 'c');
// Result: "c, b, a"
fmt::format("{0}{1}{0}", "abra", "cad");
// Result: "abracadabra"

2.2、对齐文本并指定宽度：

fmt::format("{:<30}", "left aligned");
// Result: "left aligned                  "
fmt::format("{:>30}", "right aligned");
// Result: "                 right aligned"
fmt::format("{:^30}", "centered");
// Result: "           centered           "
fmt::format("{:*^30}", "centered");  // use '*' as a fill char
									 // Result: "***********centered***********"

2.3、动态宽度：

fmt::format("{:<{}}", "left aligned", 30);
// Result: "left aligned   

2.4、动态精度：

fmt::format("{:.{}f}", 3.14, 1);
// Result: "3.1"

2.5、％ + f，％ - f和％f并指定符号：

fmt::format("{:+f}; {:+f}", 3.14, -3.14);  // show it always
										   // Result: "+3.140000; -3.140000"
fmt::format("{: f}; {: f}", 3.14, -3.14);  // show a space for positive numbers
										   // Result: " 3.140000; -3.140000"
fmt::format("{:-f}; {:-f}", 3.14, -3.14);  // show only the minus -- same as '{:f}; {:f}'
										   // Result: "3.140000; -3.140000"

2.6、％x和％o并将值转换为不同的进制：

fmt::format("int: {0:d};  hex: {0:x};  oct: {0:o}; bin: {0:b}", 42);
// Result: "int: 42;  hex: 2a;  oct: 52; bin: 101010"
// with 0x or 0 or 0b as prefix:
fmt::format("int: {0:d};  hex: {0:#x};  oct: {0:#o};  bin: {0:#b}", 42);
// Result: "int: 42;  hex: 0x2a;  oct: 052;  bin: 0b101010"

2.7、用前缀填充十六进制字节，并始终打印两个十六进制字符：

fmt::format("{:#04x}", 0);
// Result: "0x00"

2.8、使用Unicode填充的方框图：

fmt::print(
	"┌{0:─^{2}}┐\n"
	"│{1: ^{2}}│\n"
	"└{0:─^{2}}┘\n", "", "Hello, world!", 20);

输出结果：

┌────────────────────┐
│   Hello, world!│
└────────────────────┘

2.9、使用特定于类型的格式：　　

#include <fmt/chrono.h>

auto t = tm();
t.tm_year = 2010 - 1900;
t.tm_mon = 6;
t.tm_mday = 4;
t.tm_hour = 12;
t.tm_min = 15;
t.tm_sec = 58;
fmt::print("{:%Y-%m-%d %H:%M:%S}", t);
// Prints: 2010-08-04 12:15:58 

2.10、使用逗号作为千位分隔符：

#include <fmt/locale.h>

auto s = fmt::format(std::locale("en_US.UTF-8"), "{:L}", 1234567890);
// s == "1,234,567,890"

------------完------------ -

可见fmt的强大之处，类比python的格式化。 c++传统的格式化也该扫进历史的垃圾桶了。
还等什么，赶紧试试吧。