log4cplus是C++中的一个日志系统，之前有一篇文章介绍了它的配置，今天把它的使用方法列出来。对原博主在《log4cplus中自定义的使用配置文件输出日志的类》一文中存在的小瑕疵根据自己的实际情况进行修正。
要将生成的.lib和.dll文件放在.exe所在的文件夹下！！！
下面是包装过的类，在项目中使用这个类会很简单，只需要包含它的头文件就可以使用了，当然前提是搭建好log4cplus的环境。
自己定义的类名是Log
Log.h文件如下：
#pragma once
#include “log4cplus/loglevel.h”
#include “log4cplus/ndc.h”
#include “log4cplus/logger.h”
#include “log4cplus/configurator.h”
#include"log4cplus/loggingmacros.h"
#include “iomanip”
#include “log4cplus/fileappender.h”
#include “log4cplus/layout.h”
#include
using namespace std;
using namespace log4cplus;
using namespace log4cplus::helpers;
//日志封装
#define TRACELOG§ LOG4CPLUS_TRACE(Log::_logger, p)
#define DEBUGLOG§ LOG4CPLUS_DEBUG(Log::_logger, p)
#define INFOLOG§ LOG4CPLUS_INFO(Log::_logger, p)
#define WARNLOG§ LOG4CPLUS_WARN(Log::_logger, p)
#define ERRORLOG§ LOG4CPLUS_ERROR(Log::_logger, p)
// 日志控制类，全局共用一个日志
class Log
{
public:
//打开日志
bool open_log();
//获得日志实例
static Log & instance();
//全局日志对象
static Logger _logger;
private:
Log();
virtual ~Log();
};
Log.cpp文件如下：
#include “log.h”
#pragma warning(disable:4996)
wstring s2ws(const string& s){ setlocale(LC_ALL, “chs”); const char* _Source = s.c_str(); size_t _Dsize = s.size() + 1; wchar_t *_Dest = new wchar_t[_Dsize]; wmemset(_Dest, 0, _Dsize); mbstowcs(_Dest, _Source, _Dsize); wstring result = _Dest; delete[]_Dest; setlocale(LC_ALL, “C”); return result; }
//s2ws不需要了
string str=“DigitalImageProcess_log”;
std::wstring wstr = s2ws(str);//不需要了。。。
Logger Log::_logger = log4cplus::Logger::getInstance(str);//wstr
Log::Log()
{
}
Log::~Log()
{
}
Log& Log::instance()
{
static Log log;
return log;
}
bool Log::open_log()
{
log4cplus::PropertyConfigurator::doConfigure(“log4cplus.cfg”);//将要读取的配置文件的路径
return true;
}
/***********************************************************************/
/ log的使用方法：
if (!Log::instance().open_log())
{
std::cout << “Log::open_log() failed” << std::endl;
}
INFOLOG(“Server init succ”);
ERRORLOG(“Server run failed”); /
/***********************************************************************/
配置文件log4cplus.cfg如下：
log4cplus.rootLogger=INFO, STDOUT
log4cplus.logger.DigitalImageProcess_log=INFO, R3
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.appender.R3=log4cplus::RollingFileAppender
log4cplus.appender.R3.File=d:\log\DigitalImageProcess_Log.log
log4cplus.appender.R3.MaxFileSize=500KB
log4cplus.appender.R3.MaxBackupIndex=5
log4cplus.appender.R3.layout=log4cplus::PatternLayout
log4cplus.appender.R3.layout.ConversionPattern=%D{%y-%m-%d %H:%M:%S} [%l] %-5p – %m%n
主要是这3个文件，这样就可以在需要输入日志的地方使用下面的语句输出日志了：
if (!Log::instance().open_log())
{
std::cout << “Log::open_log() failed” << std::endl;
}
INFOLOG(“Server init succ”);
ERRORLOG(“Server run failed”);
在日志文件DigitalImageProcess_Log.log中会输出：
13-10-11 11:12:10 [.\TestEventHandler.cpp:15] INFO – Server init succ
13-10-11 11:12:10 [.\TestEventHandler.cpp:15] ERROR – Server run failed
配置文件中的格式如下：
（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"等等。