在 C 20 中引入的 std::format 是一个强大的工具,用于格式化字符串。它提供了一种简洁、类型安全且灵活的方式来构建格式化字符串,同时避免了传统的格式化函数带来的许多问题。
它位于头文件<format>中,使用示例如下:
代码语言:javascript复制std::string name = "Alice";
int age = 30;
std::string formatted_str = std::format("Name: {}, Age: {}", name, age);
//output:
//Name: Alice, Age: 30
文中使用{}作为占位符来进行文字替换,会产生如下三个疑问:
1.替换规则是什么?
2.如果占位符多/或少会出现什么问题呢?
3.如果输出字符串需要被{}包含时如何实现呢?
疑惑讲解
如下为std::format的构造函数之一,
代码语言:javascript复制_EXPORT_STD template <class... _Types>
_NODISCARD string format(const format_string<_Types...> _Fmt, _Types&&... _Args) {
return _STD vformat(_Fmt.get(), _STD make_format_args(_Args...));
}
为便于描述,_Fmt后续称为——“格式字符串”,_Args后续称为——“变量”
1. 变量依次替换“格式字符串”中的{};如
代码语言:javascript复制std::string name = "Alice";
int age = 30;
std::string formatted_str = std::format("Name: {}, Age: {}", name, age);
//output:Name: Alice, Age: 30
2.如果“格式字符串”中的{}数量大于变量的个数,如下例代码,编译成功,但是运行抛出“std::format_error"异常。
代码语言:javascript复制std::string formatted_str = std::format("Name: {}, {},Age: {}", "Alice", 30);//throw error
3. 如果“格式字符串”中的{}数量小于等于变量的个数,假设变量个数为n,则n个变量会替换前n个{}。
代码语言:javascript复制std::string formatted_str = std::format("Name: {},Age: {}", "Alice", 30);
std::string formatted_str = std::format("Name: {}, Age: {}", "Alice", 30,"hello");
//output:
//Name: Alice,Age: 30
//Name: Alice, Age: 30
4. 如果带输出的变量需要被{}包含,需要使用{{}}包含{}进而对{}转义,形如{{{}}},最内测的{}为占位符,而外侧的{{}}是{}的占位符
代码语言:javascript复制 std::string ret = std::format("name {} age {{ {} }}", "janny", 20);
//output:
//name janny age { 20 }
自定义数据类型的格式化
为实现自定义数据类型的格式化,需要为其提供格式化器,格式化器是标准的,可以参考如下进行修改即可。
代码语言:javascript复制#include <format>
#include <iostream>
struct vector3 {
int x, y,z;
};
// 定义一个格式化处理程序
template <>
struct std::formatter<vector3> {
auto parse(format_parse_context& ctx) { return ctx.end(); }
template <typename FormatContext>
auto format(const vector3 & p, FormatContext& ctx) const {
return std::format_to(ctx.out(), "({}, {}, {})", p.x, p.y,p.z);
}
};
void using_format()
{
vector3 p{ 10, 20,30 };
std::cout << std::format("The point is: {}n", p) << std::endl;
}
//output
//The point is: (10, 20, 30)
总结
std::format提供类型安全且灵活的字符串格式化方法,使用时要牢记{}的个数不要大于变量的个数;同时,自定义数据类型需要提供格式化器。