win10 1909+ vs2015up3 使用fmt概述

 

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;
}

 

  编译输出结果:

win10 1909+ vs2015up3 使用fmt概述

 

  :D  完。

 继续阅读文档与源码

 

win10 1909+ vs2015up3 使用fmt概述

上一篇:c#入门 流程控制


下一篇:ASP.NET Core 3.x RESTful API学习记录--HTTP 状态码;错误和故障