fmt 源码: https://github.com/fmtlib/fmt
fmt官方文档: https://fmt.dev/latest/index.html#compact-binary-code
-----------------> <---------------------
1、准备:
A、下载源码,使用cmake配置生成VS解决方案
B、编译成功的动态库fmt 文件: .dll + .lib
2、使用
这里演示,创建了一个空的项目,添加了一个main.cpp文件,文件内容如下:
添加fmt头文件:
#include "3rd_part/fmt/core.h"
链接lib文件
#pragma comment(lib, "lib/fmtd.lib")
3、示例
A、fmt::format 返回一个字符串
auto str = fmt::format("1、{0} = {1}\n\n", "1+1", 2);
B、使用 fmt::memory_buffer 可以避免构造使用string
fmt::memory_buffer out;
format_to(out, "2、For a moment, {} happened.\n\n", "nothing");
// 这里输出的也是一个char字符串
fmt::print(out.data());
注意,使用 fmt::memory_buffer 需要额外包含头文件:
// 使用 memory_buffer 包含的头文件
#include "3rd_part/fmt/format.h"
C、fmt::print输出结果
auto err_no = 1;
fmt::print(stderr, "3、System error code = {}\n\n", err_no);
fmt::print("3、Don‘t {}\n\n", "panic");
D、 Format API也支持设置位置索引(格式化)
fmt::print("4、I‘d rather be {1} than {0}.\n\n", "right", "happy");
E、可以使用fmt::arg指定替换参数的值, 这样就可以很清晰的知道每个参数的值
fmt::print("5、Hello, {name}! The answer is {number}. Goodbye, {name}.\n\n",
fmt::arg("name", "World"),
fmt::arg("number", 99) );
F、若编译器支持c++ 11用户自定义的文本, 后缀 _a提供了一种可以选。 更加简明的语法示例如下:
fmt::print("6、Hello, {name}! The answer is {number}. Goodbye, {name}.\n\n",
"name"_a = "World",
"number"_a = 42);
3、其他
fmt的类型是安全的。 自动内存管理避免了内存泄漏的情况,使用 异常捕获 或者在编译时提示格式化字符串中的错误。例如:
fmt::format("The answer is {:d}", "forty-two");上面的代码将会抛出异常: format_error 。 format_error的内容:未知的格式字符格式‘d’
因为 "forty-two" 是一个字符串, 而 格式化字符串中‘d’仅仅表示接收的是一个整数。
下面的代码 在编译的时候会抛出一个错误,原因和上面是一样的,
format(FMT_STRING("The answer is {:d}"), "forty-two");
4、宽字符的格式化
下面的代码, 当编译时,也会抛出一个错误, 因为 宽字符 L‘\x42e‘无法格式为一个普通字符串。
fmt::format("Cyrillic letter {}", L‘\x42e‘);
若需要使用宽字符, 可以使用下面的方法,格式化得到一个宽字符的字符串。 注意:格式化 字符串中多了一个 【L】
fmt::format(L"Cyrillic letter {}", L‘\x42e‘);
----------------------------------------------------------------------------------------------
main.cpp的完整源码如下:
#include "3rd_part/fmt/core.h"
// -------------------------------------------------------------------------------
// 使用 memory_buffer 包含的头文件
#include "3rd_part/fmt/format.h"
#include <string>
#include <iostream>
// _a前缀必须引用的命名空间
using namespace fmt::literals;
#pragma comment(lib, "lib/fmtd.lib")
int main(int argc, char * argv[])
{
// 1、fmt::format 返回一个字符串
auto str = fmt::format("1、{0} = {1}\n\n", "1+1", 2);
std::cout << str << std::endl;
// 2、使用 fmt::memory_buffer 可以避免构造使用string
fmt::memory_buffer out;
format_to(out, "2、For a moment, {} happened.\n\n", "nothing");
// 这里输出的也是一个char字符串
fmt::print(out.data());
// 3、fmt::print输出结果
auto err_no = 1;
fmt::print(stderr, "3、System error code = {}\n\n", err_no);
fmt::print("3、Don‘t {}\n\n", "panic");
// 4、Format API也支持设置位置索引(格式化)
fmt::print("4、I‘d rather be {1} than {0}.\n\n", "right", "happy");
// 5、可以使用fmt::arg指定替换参数的值, 这样就可以很清晰的知道每个参数的值
fmt::print("5、Hello, {name}! The answer is {number}. Goodbye, {name}.\n\n",
fmt::arg("name", "World"),
fmt::arg("number", 99) );
// 6、若编译器支持c++ 11用户自定义的文本, 后缀 _a提供了一种可以选。 更加简明的语法示例如下:
fmt::print("6、Hello, {name}! The answer is {number}. Goodbye, {name}.\n\n",
"name"_a = "World",
"number"_a = 42);
// -------------------------------------------------------------------------------
// 7、fmt的类型是安全的。 自动内存管理避免了内存泄漏的情况,使用 异常捕获 或者在编译时提示格式化字符串中的错误。例如:
// fmt::format("The answer is {:d}", "forty-two");
// 上面的代码将会抛出异常: format_error 。 format_error的内容:未知的格式字符格式‘d’
// 因为 "forty-two" 是一个字符串, 而 格式化字符串中‘d’仅仅表示接收的是一个整数。
// 下面的代码 在编译的时候会抛出一个错误,原因和上面是一样的,
// format(FMT_STRING("The answer is {:d}"), "forty-two");
// -------------------------------------------------------------------------------
// 8、下面的代码, 当编译时,也会抛出一个错误, 因为 宽字符 L‘\x42e‘无法格式为一个普通字符串。
// fmt::format("Cyrillic letter {}", L‘\x42e‘);
// 若需要使用宽字符, 可以使用下面的方法,格式化得到一个宽字符的字符串。 注意:格式化 字符串中多了一个 【L】
fmt::format(L"Cyrillic letter {}", L‘\x42e‘);
system("pause");
return 0;
}
编译输出结果:
:D 完。
继续阅读文档与源码