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

标签：而不是   value   hub   ==   print   width   int   填充   参数   

fmt 源码： https://github.com/fmtlib/fmt

本文翻译：https://fmt.dev/latest/syntax.html

fmt版本：7.0.1

本文仅为参考，请以官方文档为准。

水平有限，欢迎指正。有兴趣，参阅  官方文档。

本文仅为参考，请以 实际情况 为准。

-------------------------------- 正文开始 ---------------------------------

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

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

B、占位符语法如下：

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

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

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

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

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

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

C、Mini-Language的格式规范

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

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

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

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

　　5、各种对齐选项的含义如下：

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

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

　　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、可用的字符串表示类型为：

　　14、可用的字符显示类型为：

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

、

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

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

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

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++传统的格式化也该扫进历史的垃圾桶了。

　　还等什么，赶紧试试吧。

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

标签：而不是   value   hub   ==   print   width   int   填充   参数   

原文地址：https://www.cnblogs.com/pandamohist/p/13371511.html