log4cpp第一个程序HelloWord

body, table{font-family: 微软雅黑; font-size: 10pt}
table{border-collapse: collapse; border: solid gray; border-width: 2px 0 2px 0;}
th{border: 1px solid gray; padding: 4px; background-color: #DDD;}
td{border: 1px solid gray; padding: 4px;}
tr:nth-child(2n){background-color: #f8f8f8;}

让我们从一个简单的例子开始，该例子将两条日志信息写入字符串流，该流会在标准控制台cout上输出，项目的名称是HelloLog4Cpp：

//步凑： //1. 创建一个Appender，并指定其包含的Layout； //2. 从系统中得到Category的根，将Appender添加到该Category中； //3. 设置Category的优先级； //4. 记录日志； //5. 关闭Category。 #include <iostream> #include <log4cpp/Category.hh>               //负责向日志中写入信息 #include <log4cpp/OstreamAppender.hh>        //负责指定日志的目的地 #include <log4cpp/BasicLayout.hh>            //负责设定日志的格式 #include <log4cpp/Priority.hh>               //指定Category的优先级和日志的优先级 using namespace std; using namespace log4cpp; int main(void) { //指定日志输出目的地         OstreamAppender * pOstremAppender =                 new OstreamAppender("osAppender", &cout); //设置格式化日志信息         pOstremAppender->setLayout(new BasicLayout()); //负责输出日志         Category & root = Category::getRoot();         root.addAppender(pOstremAppender);         root.setPriority(Priority::ERROR); //写日志         root.error("hello log4cpp in a Error Message!");         root.warn("hello log4cpp in a warn Message!"); //关闭Category         Category::shutdown();         return 0; }

//系统中可以有多个Category，它们都继承自同一个跟root，每个Category负责记录自己的日志； //每个Category可以添加多个Appender(目的地，日志要输出到哪),每个Appender制定了一个日志的目的地； //这个目的地可以是文件，字符流或者windws日志，当Category记录一条日志时，该日志被写入所有 //附加到此Category的Appender； //每个Append都包含一个Layout,该Layout定义了这个Appender上日志的格式。 // #include<iostream> #include<log4cpp/Category.hh> #include<log4cpp/OstreamAppender.hh> #include<log4cpp/BasicLayout.hh> #include<log4cpp/Priority.hh> using namespace std; //引入命名空间log4cpp就可以不用加作用名限定log4cpp:: int main(int argc,char *argv[]) {         //指定日志输出目的地;附加目的地，cout，输出终端;堆对象，防止超出作用域被释放         log4cpp::OstreamAppender* osAppender = new log4cpp::OstreamAppender("osAppender",&cout);         //设置格式化日志信息;设置APPender的布局         osAppender->setLayout(new log4cpp::BasicLayout());         //负责输出日志；得到系统的根root         log4cpp::Category& root = log4cpp::Category::getRoot();         //把设置好的Append添加到系统root下         root.addAppender(osAppender);         root.setPriority(log4cpp::Priority::DEBUG);         //写日志         root.error("Hello log4cpp in a Error Message!");         root.warn("Hello log4cpp in a Warning Message!");         //关闭日志         log4cpp::Category::shutdown();         return 0; } //1514104975 ERROR  : Hello log4cpp in a Error Message! //1514104975 WARN  : Hello log4cpp in a Warning Message!

编译：g++ helloworld.cpp -o helloworld -llog4cpp -lpthread

运行结果：1248337987 ERROR : Hello log4cpp in a Error Message!

                 1248337

注：以上两条日志格式很简陋，要设置合乎心意的日志格式，请参考后续的PatternLayout章节。

相关概念：

　　Log4cpp中的概念继承自log4j，最重要的是Category(种类)、Appender(附加目的地)和Layout(布局)三个概念，此外还有Priority(优先级)和NDC(嵌套的诊断上下文)等。

　简言之，Category负责向日志中写入信息，Appender负责指定日志的目的地，Layout负责设定日志的格式，Priority被用来指定Category的优先级和日志的优先级， NDC则是一种用来区分不同场景中交替出现的日志的手段。

　　Log4cpp记录日志的原理如
下：每个Category都有一个优先级，该优先级可以由setPriority方法设置，或者从其父Category中继承而来。每条日志也有一个优先级，当Category记录该条日志时，若日志优先级高于Category的优先级时，该日志被记录，否则被忽略。系统中默认的优先级等级如下：

typedef enum { EMERG  = 0,

               FATAL  = 0,

               ALERT  = 100,

               CRIT   = 200,

               ERROR  = 300,

               WARN   = 400,

               NOTICE = 500,

               INFO   = 600,

               DEBUG  = 700,

               NOTSET = 800

     } PriorityLevel;

　 注意：取值越小，优先级越高。例如一个Category的优先级为101，则所有EMERG、FATAL、ALERT日志都可以记录下来，而其他则不能。

　 Category、
Appender和Layout三者的关系如下：系统中可以有多个Category，它们都是继承自同一个根，每个Category负责记录自己的日志;
每个Category可以添加多个Appender，每个Appender指定了一个日志的目的地，例如文件、字符流或者Windows日志，当
Category记录一条日志时，该日志被写入所有附加到此Category的Appender;每个Append都包含一个Layout，该
Layout定义了这个Appender上日志的格式。

　 现在重温前面的HelloWorld程序，可以发现其流程如下：

　　　　1. 创建一个Appender，并指定其包含的Layout；
　　　　2. 从系统中得到Category的根，将Appender添加到该Category中；
　　　　3. 设置Category的优先级；
　　　　4. 记录日志；
　　　　5. 关闭Category。

　　下面，我们按照Layout、Appender、Category、NDC的顺序来依次介绍这些概念并给出例子。