目录

一、头文件

二、初始化Initializer

三、基本配置BasicConfigurator

四、取消初始化

五、日志记录宏

六、日志级别

七、Appender输出位置

7.1 控制台输出ConsoleAppender

7.2 文件输出FileAppender

7.3 RollingFileAppender

7.4 DailyRollingFileAppender

7.5 SocketAppender

八、布局设置

8.1 SimpleLayout

8.2 PatternLayout

8.3 TTCCLayout

九、基本步骤

十、注意事项

十一、采用配置文件方式使用log4cplus

主要类说明：

主要头文件如下：

#include 我们需要用这个头文件来获取表示记录句柄的类。

#include 这个头文件声明日志记录宏。除此之外，它还声明了若干个标准日志级别： FATAL, ERROR, WARN, INFO, DEBUG, TRACE。

#include 此头文件声明类 BasicConfigurator。

#include 这个头文件声明类 Initializer。

【注】：在log4cplus2中，上述类都已经包含在头文件log4cplus.h中了，因此只需要包含该头文件即可：

#include

实例化该类会初始化log4cplus Initializer：

log4cplus::Initializer initializer;

该类还维护一个引用计数。该类可以被实例化多次。当此引用计数达到零时，在的最后一个实例被销毁后，它会关闭log4cplus内部。在log4cplus解除初始化后，无法重新初始化。

log4cplus尝试使用其他一些方法关闭其内部。但是，这意味着在main（）退出后不能使用它。

log4cplus::BasicConfigurator config; config.configure();

这两行使用简单的布局配置根记录器。ConsoleAppender

log4cplus::Logger logger = log4cplus::Logger::getInstance( LOG4CPLUS_TEXT("main"));

这里我们获得名为main的记录器的记录器句柄。

上面使用的宏与Windows上的或宏具有相同的功能：如果定义了预处理器符号，它会在作为参数传递的字符串文字前面加上前缀，使其成为宽字符串文字。

LOG4CPLUS_WARN(logger, LOG4CPLUS_TEXT(“Hello, World!”));

这里我们调用宏来记录Hello，World！将消息输入主记录器。记录的消息将从主记录器传播到根记录器，根记录器连接了一个用于在控制台上打印的日志。LOG4CPLUS_WARN()

在内部，这个宏使用C++字符串流来格式化hello, World！消息这样做的结果是，您可以使用所有标准的C++流操作器。

log4cplus试图取消初始化（deinitialize），并在退出后释放所有分配的资源。然而，同样，根据编译器、平台和运行时库的不同，这可能是不可能的。这就是为什么适当的去初始化是必要的。

在2.0及更高版本中，它由类的最后一个实例及其析构函数完成。在以前的版本中，调用是正确的关闭方法。Logger::shutdown()

宏在hood下使用C++字符串流。

此示例显示了如何在运行时通过调整实例上的日志级别阈值来过滤日志消息。

log4cplus的优先级由低到高：

各个logger可以通过setLogLevel设置自己的优先级，当某个logger的LogLevel设置 成NOT_SET_LOG_LEVEL时，该logger会继承父logger的优先级，另外，如果定义了重名 的多个logger, 对其中任何一个的修改都会同时改变其它logger。

代码示例：

RollingFileAppender可以实现滚动转储的文件操作功能： RollingFileAppender类可以根据你预先设定的大小来决定是否转储，当超过该大小，后续log信息会另存到新文件中，除了定义每个记录文件的大小之外，你还要确定在RollingFileAppender类对象构造时最多需要多少个这样的记录文件(maxBackupIndex+1)，当存储的文件数目超过maxBackupIndex+1时，会删除最早生成的文件，保证整个文件数目等于maxBackupIndex+1。然后继续记录。

DailyRollingFileAppender实现根据频度来决定是否转储的文件转储功能： DailyRollingFileAppender类可以根据你预先设定的频度来决定是否转储，当超过该频度，后续log信息会另存到新文件中，这里的频度包括：MONTHLY（每月）、WEEKLY（每周）、DAILY（每日）、TWICE_DAILY（每两天）、HOURLY（每时）、MINUTELY（每分）。 需要指出的是这里的"频度"并不是你写入文件的速度，其实是否转储的标准并不依赖你写入文件的速度，而是依赖于写入的那一时刻是否满足了频度条件，即是否超过了以分钟、小时、周、月为单位的时间刻度，如果超过了就另存。  

其中schedule为一个枚举类型，如下 enum DailyRollingFileSchedule { MONTHLY, WEEKLY, DAILY, TWICE_DAILY, HOURLY, MINUTELY};

log4cplus提供了SocketAppender，实现了C/S方式的日志记录，用于支持重定向到远程服务器。（1）客户端程序需要做的工作 定义一个SocketAppender类型的挂接器

把该挂接器加入到logger中 Logger::getRoot().addAppender(_append); SocketAppender类型不需要Layout, 直接调用宏就可以将信息发往loggerServer了 LOG4CPLUS_INFO(Logger::getRoot(), "This is a test: ")

（2）服务器端程序需要做的工作

定义一个ServerSocket ServerSocket serverSocket(port); 调用accept函数创建一个新的socket与客户端连接 Socket sock = serverSocket.accept(); 此后即可用该sock进行数据read/write了：

为了将读到的数据正常显示出来，需要将SocketBuffer存放的内容转换成InternalLoggingEvent格式：

然后输出：

注意read/write是按照阻塞方式实现的，意味着对其调用直到满足了所接收或发送的个数才返回。

log4cplus通过布局器（Layouts）来控制输出的格式，log4cplus提供了三种类型的Layouts，分别是SimpleLayout、PatternLayout、和TTCCLayout。

一种简单格式的布局器，在输出的原始信息之前加上LogLevel和一个"-"，如果初始化时没有将布局器附加到挂接器，则默认使用SimpleLayout。 以下代码片段演示了如何使用SimpleLayout。

一种有词法分析功能的模式布局器，类似于C语言的printf()函数，能够对预定义的转换标识符（conversion specifiers）进行解析，转换成特定格式输出。 以下代码片段演示了如何使用PatternLayout。

PatterLayout支持的转换标识符主要包括： （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"等等。  

TTCCLayout是在PatternLayout基础上发展的一种缺省的带格式输出的布局器， 其格式由时间，线程ID，Logger和NDC 组成（consists of time, thread, Logger and nested diagnostic context information, hence the name），因而得名。  

使用log4cplus有六个基本步骤：

代码示例：

1.如果使用ConsoleAppender()默认参数，那么控制台消息不会实时输出，需要等到缓冲区达到一定大小才会输出。当时这个可调试了好一会。因为我当时需要的效果就是实时输出到控制台与文件。代码如下：

2.输出数字、字符、字符串的方法如下：