日志库EasyLogging++学习系列（1）—

对于有开发经验的程序员来说，记录程序执行日志是一件必不可少的事情。通过查看和分析日志信息，不仅可以有效地帮助我们调试程序，而且当程序正式发布运行之后，更是可以帮助我们快速、准确地定位问题。在现在这个开源的年代，并不需要我们自己去写一套日志库，开源的版本已经有很多了。然而遗憾的是，在目前开源的C++日志库中，并没有一个在使用份额上占绝对优势的，我自己之前用过log4cplus和glog，这两个库都比较成熟了，而且网上教程也很多，所以一直都很喜欢使用这两个日志库。

前段时间，在GitHub上我偶然看到了另外一个开源的C++日志库，当时还只是粗略地研究了一下，结果竟然让我爱不释手，它就是Easylogging++。和log4cplus和glog相比，Easylogging++最大的特点就是它只有一个头文件，并且无需任何外部依赖，我从来没有见过哪一个日志库可以做到如此轻量而且还能兼顾性能的。除此之外，Easylogging++使用起来非常简单，同时还支持文件配置，提供了强大的自定义日志格式的能力，还提供对第三方库，STL容器的支持。面对如此炫酷的开源日志，怎么能不去学习学习！！！

Easylogging++项目在GitHub的开源地址：https://github.com/easylogging/easyloggingpp

功能特征

高度可配置
速度非常快
线程和类型安全
跨平台
自定义日志模式
条件日志和偶然日志
性能跟踪
详细记录日志
中断处理
辅助CHECK宏
STL 日志
第三方库日志（比如Qt, boost, wxWidgets）
可扩展性
支持Debug功能
系统日志记录
perror风格日志
C++流操作符风格日志
C 语言printf风格日志
……

版本说明

写这篇文章时，最新的 Easylogging++ 版本是V9.80，如果编译器不支持C++11的话，是无法编译的。对于Visual Studio系列来说，必须是VS2012或以上版本才行。如果还停留在VS2010、VS2008，VS2005的小伙伴，可以考虑使用EasyLogging++ V8.91版本。需要注意的是，不同的版本在使用方法和功能支持上都会有所差异。特别指出，本系列中所有的学习记录，只适用于 Easylogging++ 版本V9.80。另外，在本系列文章中出现的所有演示代码都是在 64Bit Windows 7 系统下使用 Visual Studio 2013 编译测试的。

快速使用

正如前面所说，Easylogging++使用起来非常简单，简单到什么地步呢？下面是GitHub上给出一个示例代码：

[cpp] view plaincopy print?

#include "easylogging++.h"
INITIALIZE_EASYLOGGINGPP
int main(int argv, char* argc[]) {
LOG(INFO) << "My first info log using default logger";
return 0;
}

#include "easylogging++.h"INITIALIZE_EASYLOGGINGPPint main(int argv, char* argc[]) {LOG(INFO) << "My first info log using default logger";return 0;
}

示例代码只有短短几行，每行代码的作用也一目了然：

包含easylogging++.h头文件
使用宏 INITIALIZE_EASYLOGGINGPP 初始化
使用宏 LOG(INFO) 开始日志记录

就是这么简单，只需三步，即可完成你的日志记录。这里需要特别说明的是，初始化宏 INITIALIZE_EASYLOGGINGPP 必须使用而且只能使用一次，否则将会产生编译错误。最好的放置这个初始化宏的地方是位于程序入口函数所在文件的顶部，紧跟在包含头文件的代码后面。

自定义日志

Easylogging++强大的自定义日志格式的能力是毋容置疑的，我们可以通过配置文件、配置参数、配置宏定义等方式来定义自己想要的日志格式。下面是一个利用配置文件来自定义日志的一个例子：

[cpp] view plaincopy print?

#include "easylogging++.h"
INITIALIZE_EASYLOGGINGPP
int main(int argc, char** argv)
{
el::Configurations conf("my_log.conf");
el::Loggers::reconfigureAllLoggers(conf);
LOG(TRACE) << "***** trace log *****";
LOG(DEBUG) << "***** debug log *****";
LOG(ERROR) << "***** error log *****";
LOG(WARNING) << "***** warning log *****";
LOG(INFO) << "***** info log *****";
system("pause");
return 0;
}

#include "easylogging++.h"INITIALIZE_EASYLOGGINGPPint main(int argc, char** argv)
{el::Configurations conf("my_log.conf");el::Loggers::reconfigureAllLoggers(conf);LOG(TRACE)   << "***** trace log  *****";LOG(DEBUG)   << "***** debug log  *****";LOG(ERROR)   << "***** error log  *****";LOG(WARNING) << "***** warning log  *****";LOG(INFO)    << "***** info log  *****";system("pause");return 0;
}

其中配置文件 my_log.conf 的内容如下：

[plain] view plaincopy print?

* GLOBAL:
ENABLED = true
TO_FILE = true
TO_STANDARD_OUTPUT = true
FORMAT = "[%level | %datetime] | %msg"
FILENAME = "log\\log_%datetime{%Y%M%d}.log"
MILLISECONDS_WIDTH = 3
PERFORMANCE_TRACKING = false
MAX_LOG_FILE_SIZE = 1048576
LOG_FLUSH_THRESHOLD = 0
* TRACE:
FILENAME = "log\\trace_log_%datetime{%Y%M%d}.log"
* DEBUG:
FILENAME = "log\\debug_log_%datetime{%Y%M%d}.log"
* FATAL:
ENABLED = false
* ERROR:
FILENAME = "log\\error_log_%datetime{%Y%M%d}.log"
* WARNING:
FILENAME = "log\\warning_log_%datetime{%Y%M%d}.log"
* INFO:
FILENAME = "log\\info_log_%datetime{%Y%M%d}.log"
* VERBOSE:
ENABLED = false

* GLOBAL:ENABLED                 =   trueTO_FILE                 =   trueTO_STANDARD_OUTPUT      =   trueFORMAT                  =   "[%level | %datetime] | %msg"FILENAME                =   "log\\log_%datetime{%Y%M%d}.log"MILLISECONDS_WIDTH      =   3PERFORMANCE_TRACKING    =   falseMAX_LOG_FILE_SIZE       =   1048576LOG_FLUSH_THRESHOLD     =   0* TRACE:FILENAME                =   "log\\trace_log_%datetime{%Y%M%d}.log"* DEBUG:FILENAME                =   "log\\debug_log_%datetime{%Y%M%d}.log"* FATAL:ENABLED                 =   false* ERROR:FILENAME                =   "log\\error_log_%datetime{%Y%M%d}.log"* WARNING:FILENAME                =   "log\\warning_log_%datetime{%Y%M%d}.log"* INFO:FILENAME                =   "log\\info_log_%datetime{%Y%M%d}.log"* VERBOSE:ENABLED                 =   false

通过这样的一个配置文件生成出来的日志会非常整齐，同时日志信息会保存到不同的文件中，而且还会输出到标准输出窗口。如下：

看到这里，相信对于那些以前用过类似log4cplus或者glog等日志库的小伙伴来说，其实已经完全可以上手使用Easylogging++了，剩下的部分都是一些细节或者是Easylogging++扩展性的功能介绍，这些会在后面的学习中逐渐加以记录。如果有和我一样看到并且就喜欢上Easylogging++的朋友，就让我们一起来深入了解Easylogging++并把它应用到实际的开发之中吧。

日志库EasyLogging++学习系列（1）—— 简要介绍相关推荐

日志库EasyLogging++学习系列（5）—— 辅助配置功能
正如前面<日志库EasyLogging++学习系列(3)-- 配置功能>文中最后提到的,在某些应用场景下,我们还需要通过其他的一些配置手段来辅助我们完成某些特殊功能,这些辅助配置手段包括设 ...
日志库EasyLogging++学习系列（3）—— 配置功能
在前面的文章 <日志库Easylogging++学习系列(1) -- 简要介绍 >中,我们已经初步见识到了 Easylogging++ 日志库强大的配置功能.那么配置文件中各个字段的意义是 ...
日志库EasyLogging++学习系列（10）—— 日志文件滚动
在很多应用场合,我们是需要实现日志文件滚动的,特别是在一些长期运行的服务器程序中,如果把所有的日志都记录在一个文件之中,势必会造成日志文件越来越大.当日志内容很多的时候,万一哪天突然需要查询某个日志信 ...
日志库EasyLogging++学习系列（7）—— 记录方式详解
在前面所列文章的演示代码中,其实已经展示了一部分记录日志的方式.为了使用方便,在 Easylogging++ 中,通过使用宏的集合来完成日志记录. 普通日志记录对于普通的日志记录,我们可以选择以下两 ...
日志库EasyLogging++学习系列（6）—— 日志记录器
所有的日志都是由日志记录器完成的,日志记录器使用唯一的 ID(大小写敏感)来标识.在 Easylogging++ 中默认了三个现有的日志记录器: 默认日志记录器,其 ID 为:default 性能日志 ...
日志库EasyLogging++学习系列（2）—— 日志级别
在很多的C++日志库中,日志信息会根据严重性来划分级别,使用者可以设置严重性级别门阀值来控制日志的输出,即严重性级别在该门阀值以上的日志信息才进行记录.以此不同,在Easylogging++日志库中, ...
日志库EasyLogging++学习系列（11）—— 共享日志库
在前面的学习系列文章中,我们都是在单独的一个应用程序中使用 Easylogging++ 日志库.其实 Easylogging++ 日志库是可以共享给动态库.静态库以及应用程序共同使用的.在编写一些大型 ...
日志库EasyLogging++学习系列（4）—— 格式说明符
在上一篇文章中,主要记录了如何使用 Easylogging++ 的配置功能,虽然已经用了很大的篇幅尽可能详细地加以记录,不过相信有些细心的小伙伴可能已经发现遗漏了些什么,请看下面两句摘自 my_log ...
日志库EasyLogging++学习系列（9）—— 性能跟踪功能
性能跟踪是 Easylogging++ 其中一个非常显著的功能,而且使用起来也十分简单.如果在Windows平台下使用性能跟踪的话,其原理是基于 Windows API函数 GetSystemTime ...

日志库EasyLogging++学习系列（1）—— 简要介绍

日志库EasyLogging++学习系列（1）—— 简要介绍相关推荐

最新文章

热门文章