spdlog简单介绍和使用

spdlog 是一个C++的快速、可扩展的日志库,具有高性能和友好的接口。它支持多种日志输出目标,如控制台、文件、远程服务器等,并具有强大的日志格式化和异步日志记录功能。

以下是对spdlog的简单介绍和使用示例:

安装 spdlog

你可以使用包管理工具(如CMake、vcpkg、Conan等)来安装spdlog,或者从GitHub仓库获取源代码进行构建。这里以CMake为例:

  1. 下载spdlog源代码或使用git克隆官方仓库:

    git clone https://github.com/gabime/spdlog.git
  2. 在你的CMake项目中包含spdlog:

    add_subdirectory(path_to_spdlog_source_directory)
  3. 在你的CMakeLists.txt中链接spdlog:

    target_link_libraries(your_project_name PRIVATE spdlog::spdlog)

使用 spdlog

使用spdlog非常简单,以下是一个基本的示例:

#include <spdlog/spdlog.h>

int main() {
    // 初始化spdlog,使用stdout作为输出目标
    auto console = spdlog::stdout_logger_mt("console");

    // 记录日志消息
    console->info("This is an informational message.");
    console->error("This is an error message.");
    console->critical("This is a critical message.");

    spdlog::info("Welcome to spdlog!"); 

    return 0;
}

在上述示例中,我们首先包含了spdlog头文件,然后创建了一个名为"console"的日志记录器,并将其绑定到stdout(控制台)。接着,我们使用infoerrorcritical方法记录不同级别的日志消息。

日志级别

spdlog 支持多种日志级别,包括以下几种:

  • trace: 用于追踪信息。
  • debug: 用于调试信息。
  • info: 用于一般信息。
  • warn: 用于警告信息。
  • error: 用于错误信息。
  • critical: 用于严重错误信息。

你可以根据需要选择不同的级别来记录日志。默认情况下,spdlog 的日志级别是debug,你可以在初始化日志记录器时指定不同的级别。

日志格式

spdlog 允许你自定义日志消息的格式。你可以使用占位符来指定日志消息中的各个部分,例如时间戳、日志级别、消息内容等。默认情况下,spdlog 使用一种简单的格式,但你可以通过设置自定义格式字符串来更改它。以下是一个示例:

spdlog::set_pattern("[%Y-%m-%d %H:%M:%S.%e] [%l] %v");

这个示例将时间戳、日志级别和消息内容分别用占位符表示。

spdlog 还支持异步日志记录,可以提高日志记录的性能,特别是在多线程环境中。

这只是一个spdlog的基本介绍和使用示例。你可以根据需要进一步探索其丰富的功能和配置选项,以满足特定的日志记录需求。

接下来我们详细介绍一下spdlog库的使用

创建和初始化日志记录器

在使用 spdlog 之前,需要创建和初始化一个或多个日志记录器。通常,你会在应用程序的入口处初始化日志记录器。以下是初始化日志记录器的示例:

#include <spdlog/spdlog.h>

int main() {
    // 初始化默认日志记录器,使用stdout作为输出目标
    spdlog::stdout_logger_mt("console");

    // 初始化一个自定义日志记录器,使用文件作为输出目标
    auto file_logger = spdlog::basic_logger_mt("file_logger", "my_log.txt");

    // 设置日志级别
    spdlog::set_level(spdlog::level::debug);

    // 更多初始化和设置选项...
    
    // 记录日志消息
    spdlog::get("console")->info("This is an informational message.");
    spdlog::get("file_logger")->error("This is an error message.");

    // 关闭和销毁日志记录器
    spdlog::drop("console");
    spdlog::drop("file_logger");

    return 0;
}

在上述示例中,我们首先初始化了一个默认的日志记录器("console"),并将其绑定到stdout。然后,我们初始化了一个自定义的日志记录器("file_logger"),并将其绑定到名为"my_log.txt"的文件。我们还设置了日志级别为debug,这意味着它将记录所有级别的日志。

记录日志消息

一旦初始化了日志记录器,就可以使用它来记录日志消息。spdlog 支持多种日志级别,包括 tracedebuginfowarnerror 和 critical,你可以根据需要选择不同的级别来记录日志。以下是一些示例:

spdlog::get("console")->trace("This is a trace message.");
spdlog::get("console")->debug("This is a debug message.");
spdlog::get("console")->info("This is an informational message.");
spdlog::get("console")->warn("This is a warning message.");
spdlog::get("console")->error("This is an error message.");
spdlog::get("console")->critical("This is a critical message.");

自定义日志格式

spdlog 允许你自定义日志消息的格式。你可以使用占位符来指定日志消息中的各个部分,例如时间戳、日志级别、消息内容等。默认情况下,spdlog 使用一种简单的格式,但你可以通过设置自定义格式字符串来更改它。以下是一个示例:

spdlog::set_pattern("[%Y-%m-%d %H:%M:%S.%e] [%l] %v");

这个示例将时间戳、日志级别和消息内容分别用占位符表示。

输出目标

spdlog 支持多种输出目标,包括控制台、文件、远程服务器等。你可以通过创建不同的日志记录器,并将它们绑定到不同的输出目标来实现多个日志通道。以下是一个输出目标示例:

auto file_logger = spdlog::basic_logger_mt("file_logger", "my_log.txt");

此示例将创建一个名为"file_logger"的自定义日志记录器,并将其绑定到名为"my_log.txt"的文件。

异步日志记录

spdlog 支持异步日志记录,可以提高日志记录的性能,特别是在多线程环境中。要启用异步日志记录,你可以使用以下方式初始化日志记录器:

auto async_file_logger = spdlog::basic_logger_st("async_file_logger", "async_log.txt");

在这个示例中,我们使用了_st后缀,表示启用了异步日志记录。

spdlog 还提供了许多其他功能和选项,如日志文件的切割、回滚、日志旋转等。你可以根据具体需求进一步探索这些功能。

spdlog 是一个功能强大而又易于使用的C++日志库,适用于各种应用程序。请参考 spdlog 的官方文档以获取更多详细信息和用法示例:GitHub - gabime/spdlog: Fast C++ logging library.

  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
spdlog 是一个快速的 C++ 日志库,支持多线程、异步日志等功能。以下是 spdlog使用教程: 1. 安装 spdlog spdlog 可以通过包管理器或源码编译安装。具体安装方式请参考官方文档。 2. 创建 logger 使用 spdlog,首先需要创建一个 logger 对象。logger 对象用于记录日志,并可以设置日志级别、输出格式等属性。 ```c++ #include "spdlog/spdlog.h" auto logger = spdlog::basic_logger_mt("logger_name", "log_file_path"); ``` 上面的代码创建了一个名为 "logger_name" 的 logger 对象,并将日志输出到指定的文件中。如果日志文件不存在,则会自动创建。 3. 记录日志 使用 logger 对象记录日志非常简单,只需要调用对应的函数即可。 ```c++ logger->trace("trace message"); logger->debug("debug message"); logger->info("info message"); logger->warn("warn message"); logger->error("error message"); logger->critical("critical message"); ``` 上面的代码分别记录了 trace、debug、info、warn、error 和 critical 级别的日志。 4. 设置日志级别 日志级别用于控制日志的输出,只有大于等于指定级别的日志才会被输出。默认情况下,spdlog日志级别为 debug。 ```c++ logger->set_level(spdlog::level::info); ``` 上面的代码将日志级别设置为 info,只有 info、warn、error 和 critical 级别的日志才会被输出。 5. 设置日志输出格式 可以通过设置日志输出格式,控制日志的显示方式。 ```c++ auto formatter = spdlog::pattern_formatter("[%Y-%m-%d %H:%M:%S.%e] [%L] %v"); logger->set_formatter(formatter); ``` 上面的代码设置了一个输出格式,包含时间、日志级别和日志内容。 6. 多线程和异步日志 spdlog 支持多线程和异步日志,可以提高日志记录的效率。 ```c++ auto console_sink = std::make_shared<spdlog::sinks::stdout_color_sink_mt>(); auto file_sink = std::make_shared<spdlog::sinks::basic_file_sink_mt>("log.txt", true); std::vector<spdlog::sink_ptr> sinks = {console_sink, file_sink}; auto logger = std::make_shared<spdlog::logger>("logger_name", begin(sinks), end(sinks)); logger->set_level(spdlog::level::trace); logger->flush_on(spdlog::level::info); spdlog::set_default_logger(logger); spdlog::register_logger(logger); spdlog::flush_every(std::chrono::seconds(3)); logger->trace("trace message"); logger->debug("debug message"); logger->info("info message"); logger->warn("warn message"); logger->error("error message"); logger->critical("critical message"); ``` 上面的代码创建了两个输出端,一个是控制台,一个是文件,然后将它们绑定到 logger 对象中。设置了日志级别为 trace,并且在输出 info 级别的日志时立即刷新缓存。最后设置了定时刷新缓存的时间间隔为 3 秒。 7. 总结 以上就是 spdlog使用教程,通过设置 logger 对象的属性,可以灵活地控制日志的输出方式。spdlog 支持多线程和异步日志,可以提高日志记录的效率。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

telllong

你的鼓励是我创作最大的动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值