win10 1909+ vs2015up3 使用fmt概述(fmt version 7.0.1)

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

作者：mohist

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

fmt官方文档： https://fmt.dev/latest/index.html#compact-binary-code

本文源自对官方文档的理解。

本文使用 fmt version： 7.0.1

-----------------> <---------------------

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  完。

继续阅读文档与源码