log4cplus-C++使用

很好用的一个日志库，用起来也超简单，注意一下字符集和项目统一就可以啦。

目录

1.准备工作

2.导入lib和头文件

3.配置日志库

4.配置文件详解

5.使用日志库

---

1.准备工作

需要log4cplus的lib文件，如果是动态库还需要dll，可以网上下载log4cplus的源码，我的资源里就有1.2.1版本的，在生成lib之前，需要设置log4cplus工程的  配置项：Debug还是Release，平台：字符集：等，需要和要使用的工程属性一致。

2.导入lib和头文件

在需要使用log4cplus的工程里，C/C++→常规→附加包含目录 里，加入include\log4cplus的头文件，链接器→输入→附加依赖项加载你需要的lib包，链接器→常规→附加库目录 加入lib包所在目录

3.配置日志库

//BYLogger.h
#pragma once

#include <log4cplus/loggingmacros.h>
#include <log4cplus/configurator.h>//main
#include <log4cplus/helpers/loglog.h>
#include <log4cplus/helpers/stringhelper.h>
#include <log4cplus/helpers/fileinfo.h>
#include <log4cplus/loggingmacros.h>

using namespace log4cplus;
using namespace log4cplus::helpers;

extern Logger g_rootLogger;

void InitLogger();//初始化，加载配置文件
//封装，可以不用，直接使用也可以
#define LogFatal(message) LOG4CPLUS_FATAL(g_rootLogger,LOG4CPLUS_TEXT(__FUNCTION__)<<"\t"<<message)
#define LogError(message) LOG4CPLUS_ERROR(g_rootLogger,LOG4CPLUS_TEXT(__FUNCTION__)<<"\t"<<message)
#define LogWarn(message) LOG4CPLUS_WARN(g_rootLogger,LOG4CPLUS_TEXT(__FUNCTION__)<<"\t"<<message)
#define LogInfo(message) LOG4CPLUS_INFO(g_rootLogger,LOG4CPLUS_TEXT(__FUNCTION__)<<"\t"<<message)
#define LogDebug(message) LOG4CPLUS_DEBUG(g_rootLogger,LOG4CPLUS_TEXT(__FUNCTION__)<<"\t"<<message)
#define LogTrace(message) LOG4CPLUS_TRACE(g_rootLogger,LOG4CPLUS_TEXT(__FUNCTION__)<<"\t"<<message)
#define FunctionStart() LogDebug("Start")
#define FunctionComplete() LogDebug("Complete")

---

//BYLogger.cpp
#include "BYLogger.h"

Logger g_rootLogger;

void InitLogger()
{
	log4cplus::initialize();
    //加载配置文件，如果该语句报链接错误，查看工程字符集与使用的lib字符集是否相同
	PropertyConfigurator::doConfigure(LOG4CPLUS_TEXT("log4cplus.properties"));
	g_rootLogger = Logger::getRoot();
	g_rootLogger.setLogLevel(ALL_LOG_LEVEL);//开放所有日志等级
}

---

4.配置文件详解

//log4cplus.properties  PropertyConfigurator::doConfigure的文件名，直接放在工程目录里就可以了

log4cplus.rootLogger=DEBUG, R

log4cplus.appender.R=log4cplus::AsyncAppender//异步
log4cplus.appender.R.QueueLimit=10000//队列限制
//文件输出  RollingFile文件数量达到最大后，从第一个从新开始
log4cplus.appender.R.Appender=log4cplus::RollingFileAppender
log4cplus.appender.R.Appender.File=E:\BYScanner\Log\ScannerLog.log//输出文件目录
log4cplus.appender.R.Appender.MaxFileSize=20MB//文件大小
log4cplus.appender.R.Appender.MaxBackupIndex=20//文件数量
log4cplus.appender.R.Appender.layout=log4cplus::PatternLayout//文件格式
log4cplus.appender.R.Appender.layout.ConversionPattern=
%D{%y/%m/%d %H:%M:%S.%q}	%t	%p	%L	%m%n

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"等等。

5.使用日志库

//1.导入头文件
#include "BYLogger.h"
//2.初始化logger
InitLogger();
//3.记录日志
FunctionStart();
FunctionComplete();
LogFatal("this is fatal");
LogError("this is error");
LogWarn("this is warn");
LogInfo("this is info");
LogDebug("this is debug");
LogTrace("this is trace");