Easylogging++ 使用教程

Easylogging++ 使用教程

项目地址:https://gitcode.com/gh_mirrors/eas/easyloggingpp

1. 项目的目录结构及介绍

Easylogging++ 是一个轻量级的 C++ 日志库，其 GitHub 仓库的目录结构如下：

easyloggingpp/
├── CMakeLists.txt
├── LICENSE
├── README.md
├── appveyor.yml
├── build/
├── cmake/
├── contrib/
├── doc/
├── easylogging++.cc
├── easylogging++.h
├── extras/
├── samples/
└── tests/

目录介绍：

• CMakeLists.txt: CMake 配置文件，用于构建项目。
• LICENSE: 项目的许可证文件。
• README.md: 项目说明文档。
• appveyor.yml: AppVeyor 持续集成配置文件。
• build/: 构建目录，用于存放构建生成的文件。
• cmake/: CMake 相关的模块和配置文件。
• contrib/: 贡献者提供的额外功能和工具。
• doc/: 项目文档。
• easylogging++.cc: 日志库的源文件。
• easylogging++.h: 日志库的头文件。
• extras/: 额外的功能和工具。
• samples/: 示例代码，展示如何使用 Easylogging++。
• tests/: 测试代码，用于测试日志库的功能。

2. 项目的启动文件介绍

Easylogging++ 的启动文件主要是 easylogging++.h 和 easylogging++.cc。这两个文件包含了日志库的所有功能。

启动文件介绍：

• easylogging++.h: 头文件，包含了日志库的所有声明和定义。
• easylogging++.cc: 源文件，包含了日志库的实现代码。

在使用 Easylogging++ 时，只需包含 easylogging++.h 头文件，并使用宏 INITIALIZE_EASYLOGGINGPP 进行初始化。

#include "easylogging++.h"

INITIALIZE_EASYLOGGINGPP

int main(int argc, char* argv[]) {
    LOG(INFO) << "My first info log using default logger";
    return 0;
}

3. 项目的配置文件介绍

Easylogging++ 支持通过配置文件进行配置。配置文件通常是一个文本文件，可以使用 el::Configurations 类进行加载和设置。

配置文件示例：

* GLOBAL:
   FORMAT = "%datetime %level %msg"
   FILENAME = "logs/myapp.log"
   ENABLED = true
   TO_FILE = true
   TO_STANDARD_OUTPUT = true
   SUBSECOND_PRECISION = 3
   PERFORMANCE_TRACKING = true
   MAX_LOG_FILE_SIZE = 2097152 ## 2MB
   LOG_FLUSH_THRESHOLD = 100 ## Flush after every 100 logs

加载配置文件：

#include "easylogging++.h"

INITIALIZE_EASYLOGGINGPP

int main(int argc, char* argv[]) {
    el::Configurations conf("my_log.conf");
    el::Loggers::reconfigureAllLoggers(conf);

    LOG(INFO) << "This log will use the configuration from my_log.conf";
    return 0;
}

通过这种方式，可以灵活地配置 Easylogging++ 的行为，包括日志格式、输出文件、性能跟踪等。

easyloggingpp 项目地址: https://gitcode.com/gh_mirrors/eas/easyloggingpp