簡介
log4cplus是log4j的c++移植版，是c++中一個很好的打印日志的庫。它與另外一個c++的log庫log4cxx相比較，好處是不依賴於libapr和libaprutil，可以靜態鏈接到程序中，便於部署。
安裝
tar xvzf log4cplus-x.x.x.tar.gz
cd log4cplus-x.x.x
./configure --prefix=/where/to/install
make
make install
這里我采用缺省安裝路徑：/usr/local
頭文件在/usr/local/include/log4cplus目錄下，使用的時候需要連接動態庫或靜態庫均可，/usr/local/lib/liblog4cplus.a（靜態庫）或 log4cplus（動態庫）。
配置說明
文件：log.properties
log4cplus.rootLogger=ERROR, R
log4cplus.appender.R=log4cplus::DailyRollingFileAppender
log4cplus.appender.R.File=./log/error.log
log4cplus.appender.R.Schedule=HOURLY
log4cplus.appender.R.Append=true
log4cplus.appender.R.layout=log4cplus::PatternLayout
log4cplus.appender.R.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S,%Q}] [%t] %-5p - %m%n
log4cplus提供一個類【PropertyConfigurator】來實現從文件讀取配置，參數就是文件名。其他參數采用默認。
配置文件內容如下：
1. 選擇logger
Logger logger = Logger::getRoot(); 這個用來選擇rootLogger的
其他的還可以配置更多的logger，Logger logger = log4cplus::Logger::getInstance("test");
一般情況下不是很需要。
2. 日志輸出級別 TRACE
logger名稱之后的第一個參數可以控制日志輸出，如在debug環境中，輸出各種debug信息，而在線上環境中，則只需要輸出info和各類錯誤信息。log4cplus支持如下日志級別，使用方法可以看cpp代碼。
•TRACE •DEBUG •INFO •WARN •ERROR •FATAL
上述各種級別中，從上往下，重要性依次遞增。而在配置文件中的級別會屏蔽掉比它重要性更低的日志輸出。
3. appender配置
每個logger可以添加appender，在logger后面的第二個參數即為apppender
如這個例子：log4cplus.rootLogger=ERROR, R
名稱為R的appender
在appender上可以設置日志輸出位置、日志路徑、layout等等內容
a． 日志文件名
通過配置項：log4cplus.appender.R.File=./log/error.log
4. appender輸出位置
（1）控制台輸出
ConsoleAppender
（2）文件輸出
FileAppender / RollingFileAppender / DailyRollingFileAppender .
5. layout
layout是控制日志輸出格式的
log4cplus.appender.R.layout=log4cplus::PatternLayout
log4cplus.appender.R.layout.ConversionPattern=[%D{%Y-%m-%d%H:%M:%S,%Q}] [%t] %-5p - %m%n
格式包括三種類型：
1.) SimpleLayout 是一種簡單格式的布局器，在輸出的原始信息之前加上LogLevel和一個"-"。
2.) TTCCLayout 其格式由時間，線程ID，Logger和NDC 組成。
3.) PatternLayout 是一種有詞法分析功能的模式布局器,類似正則表達式。以“%”作為開頭的特殊預定義標識符，將產生特殊的格式信息。
在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"等等。
本例使用：log4cplus.appender.R.layout.ConversionPattern=[%D{%Y-%m-%d%H:%M:%S,%Q}] [%t] %-5p - %m%n
實例
配置log.properties
log4cplus.rootLogger=ERROR, R
log4cplus.appender.R=log4cplus::DailyRollingFileAppender
log4cplus.appender.R.File=./log/error.log
log4cplus.appender.R.Schedule=HOURLY
log4cplus.appender.R.Append=true
log4cplus.appender.R.layout=log4cplus::PatternLayout
log4cplus.appender.R.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S,%Q}] [%t] %-5p - %m%n[%p]
log4cplus.logger.test=TRACE, RR
log4cplus.appender.RR=log4cplus::DailyRollingFileAppender
log4cplus.appender.RR.File=./log/test.log
log4cplus.appender.RR.MaxBackupIndex=192 #8 * 24
log4cplus.appender.RR.Schedule=HOURLY
log4cplus.appender.RR.Append=true
log4cplus.appender.RR.layout=log4cplus::PatternLayout
log4cplus.appender.RR.layout.ConversionPattern=%p %D{%Y-%m-%d %H:%M:%S.%q}:%t %F:%L "%m"%n
test.cpp
#include <cstdlib>
#include <log4cplus/logger.h>
#include <log4cplus/configurator.h>
#include <log4cplus/helpers/loglog.h>
#include <log4cplus/helpers/stringhelper.h>
using namespace std;
using namespace log4cplus;
using namespace log4cplus::helpers;
int main()
{
PropertyConfigurator::doConfigure(LOG4CPLUS_TEXT("log.properties"));
Logger logger = Logger::getRoot();
// trace
LOG4CPLUS_TRACE(logger, "trace and get the fingerprint: " << "random integer: " << random());
// debug
LOG4CPLUS_DEBUG(logger, "this is debug log: " << "random integer: "<< random());
// info
LOG4CPLUS_INFO(logger, "the information centry...." << "[ 1 + 1 = " << 1 + 1 << "]");
// warn
LOG4CPLUS_WARN(logger, "Writing warning messages to log....");
// error
LOG4CPLUS_ERROR(logger, "ooooooh, there is an error....");
//fatal
LOG4CPLUS_FATAL(logger, "oh, my god! the fatal error occur!!!!!!!!!");
//
Logger loggerTest = log4cplus::Logger::getInstance("test");
LOG4CPLUS_TRACE(loggerTest,"anther logger,trace");
LOG4CPLUS_ERROR(loggerTest,"anther logger,error ");
return 0;
}
CC:=g++
CFLAGS:= -g
SRC:= test.cpp
DEST:=client
INCLUDE_PATH:=/usr/local/include
LIB_PATH:=/usr/local/lib
USER_LIBRARIES:=log4cplus
#
H_LIB_PATH := $(foreach n,$(LIB_PATH),-L$(n))
H_USER_LIBRARIES := $(foreach n,$(USER_LIBRARIES),-l$(n))
H_INC_PATH := $(foreach n,$(INCLUDE_PATH),-I$(n))
OBJS:=$(SRC:.cpp=.o)
#
all:tips $(OBJS) $(DEST)
tips:
@echo "begin compile"
$(OBJS):%.o:%.cpp
$(CC) $(CFLAGS) $(H_INC_PATH) -c $? -o $@
$(DEST):$(OBJS)
$(CC) $(CFLAGS) $(H_LIB_PATH) $(H_USER_LIBRARIES) $? -o $@
#
clean:
rm -rf $(DEST) $(OBJS)
在當前目錄下：
make，編譯出可執行文件client
建一個log目錄
./client
你的日志出來了
封裝
每次使用LOG4CPLUS_TRACE, LOG4CPLUS_ERROR肯定不爽，我們可以做一個簡單的封裝，請參考下一篇日志log4cplus的封裝