带你了解gLog库，一篇gLog库的总结

一、概述

Google glog是一个基于程序级记录日志信息的C++库，编程使用方式与c++的stream操作类似，例如：
LOG(INFO) << “one” << “two” << “three”;

“LOG”宏为日志输出关键字，”INFO”为严重性程度。

主要支持功能：

1、严重性分级记录信息：INFO、WARNING、ERROR、FATAL。

2、可以有条件地记录日志信息。

3、有条件终止程序。丰富的条件判断定宏，可预设程序终止条件。

4、异常信号处理。程序异常情况，可自定义异常处理过程。

5、支持debug功能。可只用于debug模式。

6、线程安全日志记录方式。

7、系统级日志记录。

8、 Google perror风格日志信息。

9、精简日志字符串信息。

二、功能使用

2.1 严重性分级记录信息

glog可通过指定的严重性等级，来选择性记录日志。日志信息严重性等级按由低到高排列依次为：INFO、WARNING、ERROR和FATAL四级。

2.2 可以有条件地记录日志信息

glog可以控制日志信息再指定条件下进行记录。具体使用如下：

1、 LOG_IF(INFO, num_cookies > 10) << “Got lots of cookies”;

上面的语句表示，只有当num_cookies > 10条件成立时，”Got lots of cookies”日志信息才被记录。

2、 LOG_EVERY_N(INFO, 10) << “Got the ” << COUNTER << “the cookies”;

上面的语句表示，在程序中周期性的记录日志信息，在该语句第1、11、21.....次被执行的时候，记录日志信息。COUNTER变量表示该语句被执行的次数。

3、 LOG_IF_EVERY_N(INFO, (size > 1024), 10) << “Got the “ << counter << “the big cookies”;

上面的语句为1，2项功能的合并，size>1024的条件连续成立10次的时候记录日志信息。COUNTER变量表示该条件成立的次数。

4、 LOG_FIRST_N(INFO, 20) << “Got the ” << counter << “the cookies”;

上面的语句表示，当该语句只在首次执行了20次以后记录日志信息， COUNTER变量表示该语句被执行的次数。

2.3 有条件终止程序

glog提供了CHECK宏，用于在调试地时候中止程序，及早发现程序错误。当通过该宏指定的条件不成立的时候，程序会中止，并且记录对应的日志信息。功能类似于ASSERT，区别是CHECK宏不受NDEBUG约束，在release版中同样有效。具体使用如下：

CHECK(fp->Write(x) == 4) << “Write failed!”;

当fp->Write(x) == 4成立时，记录“Write failed!”日志信息，并且中止程序，其中fp->Write(x) == 4为判定条件，日志信息以c++的stream操作形式生成。

glog提供了多个便利的宏来处理特定关系的判定。具体有：

1、判定大小关系

CHECK_EQ, CHECK_NE, CHECK_LE, CHECK_LT, CHECK_GE, CHECK_GT，使用这些宏需要注意类型一致，如果出现类型不一致的，可使用static_cast转换。

2、判定指针是否为空

CHECK_NOTNULL（some_ptr），可用于对象初始化的时候。

3、判定字符串是否相等

CHECK_STREQ, CHECK_STRNE, CHECK_STRCASEEQ, CHECK_STRCASENE。可进行大小写敏感或不敏感字符串来分别判定。

4、判定浮点是否相等或相近

CHECK_DOUBLE_EQ，CHECK_NEAR。这两个宏都需要指定一个可容忍的偏差上限。
当这些宏判定条件不成立时，glog会生成一个FATAL级别的日志信息，该信息包含比较的两个值和stream方式传入的字符串，然后中止程序。

2.4 异常信号处理

glog提供了比较方便的程序异常处理机制。例如，当程序出现SIGSEGV异常信号时，glog的默认异常处理过程会导出非常有用的异常信息。异常处理过程可以通过google::InstallFailureSignalHandler()来自定义。下面为异常处理过程的输出例子：

*** Aborted at 1225095260 (unix time) try “date -d @1225095260” if you are using GNU date ***

默认情况下，异常信息是输出到stderr，通过InstallFailureWriter（）可以改变输出目标。

2.5 支持debug功能

glog提供特定的宏只在debug模式下生效。以下分别对应LOG、LOG_IF、DLOG_EVERY_N操作的专用宏。

DLOG(INFO) << “Found cookies”;

DLOG_IF(INFO, num_cookies > 10) << “Got lots of cookies”;

DLOG_EVERY_N(INFO, 10) << "Got the " << COUNTER << “the cookies”;

2.6 线程安全日志记录方式

glog提供了线程安全的日志记录方式。在<glog/raw_logging.h>文件中提供了相关的宏，如，RAW_CHECK，RAW_LOG等。这些宏的功能与CHECK，LOG等一致，除此以外支持线程安全，不需要为其分配任何内存和提供额外的锁（lock）机制。

2.7 系统级日志记录

glog除了提供了普通的日志记录宏，还提供SYSLOG, SYSLOG_IF,和 SYSLOG_EVERY_N宏，这些宏将日志信息通过syslog()函数记录到系统日志。

2.8 Google perror风格日志信息

glog提供了与LOG*和CHECK宏作用等价的PLOG()、PLOG_IF() 和PCHECK()宏，不同的是，后者在记录日志信息的时候，会将errno的状态及其描述附加到日志描述中。

如：

PCHECK(write(1, NULL, 2) >= 0) << “Write NULL failed”;

当条件不成立时，会输出日志信息：

F0825 185142 test.cc:22] Check failed: write(1, NULL, 2) >= 0 Write NULL failed: Bad address [14]

2.9 精简日志字符串信息

日志信息的字符串会占用比较大的内存空间，另外还带来隐私泄露的问题。glog提供了GOOGLE_STRIP_LOG宏在编译时候去除日志的字符串信息。