作为C++领域中为数不多的好用、高效的、跨平台的日志工具,Google的开源日志库glog也算是凤毛麟角了。glog 是一个C++实现的应用级日志记录框架,提供了C++风格的流操作。
恰巧趁着五一我也学习研究了这个glog库,写个总结如下。走过路过的的各位牛人、高手可以忽略这篇文章了。
从code.google.com下载源码(在这里),在Visual Studio 2010中打开工程,如下:
可见只有四个工程,其中libglog和libglog_static分别是Windows下的动态库和静态库,其实代码都是一样的,另外两个工程分别是测试工程(也是同一套代码),看名字都就知道了。
glog实现代码并不多,代码量统计如下:
从上面看出真正有效的C/C++代码也就8000行以内吧。
直接编译,注意,竟然不能编译通过!!!我这里下载的是SVN 地址http://google-glog.googlecode.com/svn/trunk/上的r142版本,从编译错误可以找到原因,简单修改即可全部编译成功,就是将文件logging.cc中的第183、189、199、205行的ssize_t改为size_t,如下:
实在不明白为什么还有这种情况发生,难道不应该至少保证编译没问题才会commit代码的么。而直接下载的稳定版(glog-0.3.3.tar.gz )则没有这个问题,看来开发版本都是不可靠的啊。
把所有代码从每个文件的代码量和实现复杂度做一个整体分析。
按代码行数排序:
按复杂度排序(复杂度定义在不同工具中有不同表示,这里仅作参考):
从这里也基本能看出重要的文件或函数实现了。另外按复杂度排序是排名第一的文件叫做demangle.cc,你在VS工程里并没有发现有这个cc,甚至都没有include相应的demangle.h,这个文件是干嘛的?随后再作分析(其实单看文件名就基本能猜到了)。
其中logging.cc是主要的功能实现,对该文件的分析如下:
logging.cc中函数复杂度如下:
当然,不同人使用不同的分析工具,导致上面的结果会有一定的差异,仍以logging.cc为例,使用另外工具分析函数复杂度部分结果如下:
注意函数LogFileObject::Write和TruncateLogFile的复杂度排序计算值和排序顺序都不相同,但总体上来说都算是正常的,也算是都能管中窥豹吧。
有了这些简单的统计分析,接下来浏览代码就相对有方向性了,不过话说这个代码量总体来说也不多。像该代码中使用了大量的宏技巧,初看还是不好理解的,接下来会从代码上做点分析理解。
一直没有介绍glog,但是,如果你了解glog,那你肯定知道些什么了。最后把glog的特性或者说功能简单摘抄如下(处处都有,不显示引用原作了):
- 参数设置,以命令行参数的方式设置标志参数来控制日志记录行为;
- 严重性分级,根据日志严重性分级记录日志;
- 可有条件地记录日志信息;
- 条件中止程序。丰富的条件判定宏,可预设程序终止条件;
- 异常信号处理。程序异常情况,可自定义异常处理过程;
- 支持debug功能。可只用于debug模式;
- 自定义日志信息;
- 线程安全日志记录方式;
- 系统级日志记录;
- google perror风格日志信息;
- 精简日志字符串信息。
好吧这里还是给出我引用的文章:
http://google-glog.googlecode.com/svn/trunk/doc/glog.html#verbose