下载地址: :http://sourceforge.net/projects/log4cplus/
非常棒的中文文档:
(可直接去人家的分类里有列表:)
如果上面的链接是正常的,下面的内容别不看了浪费时间。
1.简 介
log4cplus是C++编写的开源的日志系统,前身是java编写的log4j系统.受Apache Software License保护。作者是Tad E. Smith。 log4cplus具有线程安全、灵活、以及多粒度控制的特点,通过将信息划分优先级使其可以面向程序调试、运行、测试、和维护等全生命周期;你可以选择将信息输出到屏幕、文件、NT event log、甚至是远程服务器;通过指定策略对日志进行定期备份等等。 2.下 载最新的log4cplus可以从以下网址下载。:http://sourceforge.net/projects/log4cplus/3.安 装#tar xvzf log4cplus-1.0.4-rc10.tar.gz#cd log4cplus-1.0.4-rc10#./configure --prefix=/usr/local#make#make install安装成功会在/usr/local/lib下看到 liblog4cplus.a,在/usr/local/include下有个liblog4cplus文件夹4.配 置
确保你的Makefile中包含 /usr/local/lib/liblog4cplus.a(静态库)或-llog4cplus(动态库)即可。头文件在/usr /local/include/log4cplus目录下。对于动态库,要想正常使用,还得将库安装路径加入到 LD_LIBRARY_PATH 中,以管理员身份登录,在/etc/ld.so.conf中加入安装路径,这里是/usr/local/lib,然后执行 ldconfig使设置生效即可。
5.运行测试程序
直接运行源码包中tests目录下的测试程序
6.log4cp lus内容介绍 1.log4cplus基本元素
Layouts :控制输出消息的格式。 Appenders :输出位置。 Logger :日志对象。 Priorities :优先权,包括TRACE, DEBUG, INFO, WARNING, ERROR, FATAL。
2.log4cplus基本结构
转载自:
3. 使用步骤:
a.) 生成Appender对象。
b.) 生成Layout对象,并绑定到Appender。(可选)
c.) 生成Logger对象。
d.) 设置Logger优先级。(可选)
e.) 将需要关联Logger的Appender添加到Logger上。
f.) 使用Logger输出信息,所有大于设定的优先级的信息,并在所有挂接在该Logger对象上的Appender上以相应的Layout设定的格式显示出来。
4. Logger对象
Logger对象具有层次结构,按名称区分,如下代码:
Logger test = Logger::getInstance("test"); Logger subtest = Logger::getInstance("test.subtest");
对象subtest是test的子对象。
5. 优先级
log4cplus优先级有低到高:
NOT_SET_LOG_LEVEL :接受缺省的LogLevel,如果有父logger则继承它的LogLevel ALL_LOG_LEVEL :开放所有log信息输出 TRACE_LOG_LEVEL :开放trace信息输出(即ALL_LOG_LEVEL) DEBUG_LOG_LEVEL :开放debug信息输出 INFO_LOG_LEVEL :开放info信息输出 WARN_LOG_LEVEL :开放warning信息输出 ERROR_LOG_LEVEL :开放error信息输出 FATAL_LOG_LEVEL :开放fatal信息输出 OFF_LOG_LEVEL :关闭所有log信息输出
各个logger可以通过setLogLevel设置自己的优先级,当某个logger的LogLevel设置成NOT_SET_LOG_LEVEL时,该logger会继承父logger的优先级,另外,如果定义了重名的多个logger, 对其中任何一个的修改都会同时改变其它logger。
6.Layout格式输出
1.) SimpleLayout 是一种简单格式的布局器,在输出的原始信息之前加上LogLevel和一个"-"。
2.) TTCCLayout 其格式由时间,线程ID,Logger和NDC 组成。
3.) PatternLayout
是一种有词法分析功能的模式布局器,类似正则表达式。以“%”作为开头的特殊预定义标识符,将产生特殊的格式信息。
(1)"%%",转义为% 。
(2)"%c",输出logger名称,如test.subtest 。也可以控制logger名称的显示层次,比如"%c{1}"时输出"test",其中数字表示层次。 (3)"%D",显示本地时间,比如:"2004-10-16 18:55:45",%d显示标准时间。 可以通过%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",输出当前记录器所在的文件名称,比如"main.cpp" (5)"%L",输出当前记录器所在的文件行号,比如"51" (6)"%l",输出当前记录器所在的文件名称和行号,比如"main.cpp:51" (7)"%m",输出原始信息。 (8)"%n", 换行符。
(9)"%p",输出LogLevel,比如"DEBUG" (10)"%t",输出记录器所在的线程ID,比如 "1075298944" (11)"%x",嵌套诊断上下文NDC (nested diagnostic context) 输出,从堆栈中弹出上下文信息,NDC可以用对不同源的log信息(同时地)交叉输出进行区分。 (12)格式对齐,比如"%-10m"时表示左对齐,宽度是10,当然其它的控制字符也可以相同的方式来使用,比如"%-12d","%-5p"等等。
7.) Appender输出位置
(1)控制台输出
ConsoleAppender
(2)文件输出
FileAppender / RollingFileAppender / DailyRollingFileAppender .
FileAppender :
实现了基本的文件操作功能,构造函数如下:
FileAppender(filename,mode,immediateFlush);
<filename > 文件名 <mode> 文件类型,可选择的文件类型包括app,ate,binary,in,out,trunc。缺省是trunc,表示将先前文件删除。 <immediateFlush> 缓冲刷新标志.
RollingFileAppender:
RollingFileAppender(filename,maxFileSize,maxBackupIndex,immediateFlush) filename : 文件名 maxFileSize : 文件的最大尺寸 maxBackupIndex : 最大记录文件数 immediateFlush : 缓冲刷新标志
可以根据你预先设定的大小来决定是否转储,当超过该大小,后续log信息会另存到新文件中,除了定义每个记录文件的大小之外,你还要确定在 RollingFileAppender类对象构造时最多需要多少个这样的记录文件(maxBackupIndex+1),当存储的文件数目超过 maxBackupIndex+1时,会删除最早生成的文件,保证整个文件数目等于maxBackupIndex+1 。
DailyRollingFileAppender:
DailyRollingFileAppender(filename, schedule,immediateFlush, maxBackupIndex) filename : 文件名 schedule : 存储频度 immediateFlush : 缓冲刷新标志 maxBackupIndex : 最大记录文件数
DailyRollingFileAppender类可以根据你预先设定的频度来决定是否转储,当超过该频度,后续log信息会另存到新文件中,这里的频度包
转载来源:http://myswirl.blog.163.com/blog/static /51318642201071644948257/
添加:
log4cplus是一款优秀的基于C/C++的开源日志库。log4cplus具有线程安全,不用但心在多线程状态下写日志问题;使用灵活,可通过配置文件设置日志级别下输出位置,还可以在程序运行时动态设置日志输出级别,随心所欲掌控日志的输出;以及多粒度控制的特点。通过将信息划分优先级使其可以面向程序调试、运行、测试、和维护等全生命周期; 可以选择将信息输出到屏幕、文件、NT event log、甚至是远程服务器;通过指定策略对日志进行定期备份。可以满足大部分开发者对日志系统需求,功能全面。
下载地址:tar -xjf log4cplus-1.0.4.tar.bz2(解压缩),切换到解压缩路径下安装:./configure;make;make install这里已经安装成功,默认的路径lib库路径是/usr/local/lib/,头文件的位置:/usr/local/include/log4cplus将/usr/local/lib下的和log4cplus相关的库都拷贝到/usr/lib,将头文件加到/etc/profile下的CPLUS_INCLUDE_PATH这里要强调是使用log4cplus时,要 加上-llog4cplus -lrt -lpthread -lrt(或者 -llog4cplus -lpthread ),才能顺利的编译通过和使用;转载自: