以前是看过的,后来由于没用又忘光了。现在又重新看,好浪费时间。
费话不多说。
Log4cplus 概述
首先,log4cplus是一个日志记录的库,目的很简单,就是把合适的信息送到正确的位置上去。
Log4cplus 由4部分组成:
1>Logger 日志模块,程序中唯一一个必须得使用的模块,解决了在哪里使用日志的问题
2> Appenders 接收日志的各个设备,如控制台、文件、网络等。解决了输出到哪里去的问题
3>Layout 格式化输出信息,解决了如何输出的问题。
4>Filter 过滤器,解决哪些信息需要输出的问题,比如DEBUG,WARR,INFO等的输出控制.
Log4cplus的主要部件关系图如下:
Log4cplus格式化输出字符串
来源:http://log4cplus.sourceforge.net/docs/html/classlog4cplus_1_1PatternLayout.html
http://www.cppblog.com/tx7do/articles/11717.html
关于预定义标识符,log4cplus文档中提供了详细的格式说明,我每种都试了一下,以上述代码为例,根据不同
的pattern,各种消息格式使用情况列举如下:
(1)"%%",转义为%, 即,std::string pattern = "%%" 时输出: "%"
(2)"%c",输出logger名称,比如std::string pattern ="%c" 时输出: "test_logger.subtest",
也可以控制logger名称的显示层次,比如"%c{1}"时输出"test_logger",其中数字表示层次。
(3)"%D",显示本地时间,当std::string pattern ="%D" 时输出:"2004-10-16 18:55:45",%d显示标准时间,
所以当std::string pattern ="%d" 时输出 "2004-10-16 10:55:45" (因为我们是东8区,差8个小时啊)。
可以通过%d{...}定义更详细的显示格式,比如%d{%H:%M:%s}表示要显示小时:分钟:秒。大括号中可显示的
预定义标识符如下:
%a -- 表示礼拜几,英文缩写形式,比如"Fri"
%A -- 表示礼拜几,比如"Friday"
%b -- 表示几月份,英文缩写形式,比如"Oct"
%B -- 表示几月份,"October"
%c -- 标准的日期+时间格式,如 "Sat Oct 16 18:56:19 2004"
%d -- 表示今天是这个月的几号(1-31)"16"
%H -- 表示当前时刻是几时(0-23),如 "18"
%I -- 表示当前时刻是几时(1-12),如 "6"
%j -- 表示今天是哪一天(1-366),如 "290"
%m -- 表示本月是哪一月(1-12),如 "10"
%M -- 表示当前时刻是哪一分钟(0-59),如 "59"
%p -- 表示现在是上午还是下午, AM or PM
%q -- 表示当前时刻中毫秒部分(0-999),如 "237"
%Q -- 表示当前时刻中带小数的毫秒部分(0-999.999),如 "430.732"
%S -- 表示当前时刻的多少秒(0-59),如 "32"
%U -- 表示本周是今年的第几个礼拜,以周日为第一天开始计算(0-53),如 "41"
%w -- 表示礼拜几,(0-6, 礼拜天为0),如 "6"
%W -- 表示本周是今年的第几个礼拜,以周一为第一天开始计算(0-53),如 "41"
%x -- 标准的日期格式,如 "10/16/04"
%X -- 标准的时间格式,如 "19:02:34"
%y -- 两位数的年份(0-99),如 "04"
%Y -- 四位数的年份,如 "2004"
%Z -- 时区名,比如 "GMT"
(4)"%F",输出当前记录器所在的文件名称,比如std::string pattern ="%F" 时输出: "main.cpp"
(5)"%L",输出当前记录器所在的文件行号,比如std::string pattern ="%L" 时输出: "51"
(6)"%l",输出当前记录器所在的文件名称和行号,比如std::string pattern ="%L" 时输出:
"main.cpp:51"
(7)"%m",输出原始信息,比如std::string pattern ="%m" 时输出: "teststr",即上述代码中
LOG4CPLUS_DEBUG的第二个参数,这种实现机制可以确保原始信息被嵌入到带格式的信息中。
(8)"%n",换行符,没什么好解释的
(9)"%p",输出LogLevel,比如std::string pattern ="%p" 时输出: "DEBUG"
(10)"%t",输出记录器所在的线程ID,比如std::string pattern ="%t" 时输出: "1075298944"
(11)"%x",嵌套诊断上下文NDC (nested diagnostic context) 输出,从堆栈中弹出上下文信息,NDC可以用对
不同源的log信息(同时地)交叉输出进行区分,关于NDC方面的详细介绍会在下文中提到。
(12)格式对齐,比如std::string pattern ="%-10m"时表示左对齐,宽度是10,此时会输出"teststr ",当
然其它的控制字符也可以相同的方式来使用,比如"%-12d","%-5p"等等(刚接触log4cplus文档时还以为
"%-5p"整个字符串代表LogLevel呢,呵呵)。
Log4cplus 配置文件
在log4cplus中的配制文件基本与log4j的配置文件一样。
以下面为例
log4cplus.rootLogger=INFO, STDOUT, R
log4cplus.logger.test=WARN
log4cplus.logger.test.log_1=FATAL
log4cplus.logger.test.log_2=FATAL
log4cplus.logger.test.log_3=WARN
log4cplus.appender.STDOUT=log4cplus::ConsoleAppender
log4cplus.appender.STDOUT.layout=log4cplus::PatternLayout
log4cplus.appender.STDOUT.layout.ConversionPattern=%d{%m/%d/%y %H:%M:%S} [%t] %-5p %c{2} %%%x%% - %m [%l]%n
log4cplus.rootLogger= INFO, STDOUT, R
其中第一个INFO是等级,从大到小包括 <!--[if !vml]--><!--[endif]-->
OFF、FATAL、ERROR 、WARN 、INFO、DEBUG 、TRACE、ALL
后面STDOUT与R都是自定义的appender名称,表示该日志将会输出到哪几个appender中去。
Log4cplus 安装
Log4cplus 在中的使用
LOG4CPLUS_TRACE
LOG4CPLUS_DEBUG
LOG4CPLUS_INFO
LOG4CPLUS_WARN
LOG4CPLUS_ERROR
LOG4CPLUS_FATAL
相关资料
Log4cplus是从java中的日志log4j那里移植过来的一个日志库。
http://www.cppblog.com/tx7do/articles/11715.html
http://www.blogjava.net/zJun/archive/2006/06/28/55511.html
http://log4cplus.sourceforge.net/hello_world.html
剩余的就在 log4cplus 的 test目录下看看吧。
posted on 2009-02-17 21:08
鹿哥 阅读(5788)
评论(0) 编辑 收藏 引用 所属分类:
LOG4CPLUS