【Linux】浅易日志体系

目录
一、概念
二、可变参数
三、日志体系

---

一、概念

一个正在运行的程序或体系就像一个哑巴，一旦开始运行我们很难知晓其内部的运行状态。
但有时在程序运行过程中，我们想知道其内部不同时刻的运行效果如何，这时一个日志体系可以有用的资助我们监控程序的运行状态。
如果体系或程序发生了错误或存在bug，通过日志的内容我们也可以很快的知道故障的原因并定位错误的位置
一个成熟的日志至少需要包罗以下信息：

• 日志时间
  
• 日志等级
  

根据环境可将日志划分为不同的等级，比方常规信息、告诫信息、严重错误、致命错误、调试信息

• 日志内容
  
• 文件名称或行号
  

---

二、可变参数

日志的内容需要我们指定格式并传参，而参数的个数是不确定的。因此在学习编写日志体系之前，我们先了解一下可变参数的用法
以下是对可变参数举行操纵时需要用到的函数/宏

1. #include <stdarg.h>
3. void va_start(va_list ap, last);
4. type va_arg(va_list ap, type);
5. void va_end(va_list ap);

复制代码

我们以一个可以同时累加多个变量的函数为例：

1. int sum(int n, ...)
2. {}

复制代码

形参在实例化时会从右向左举行压栈，也就是说多个参数在函数栈帧中是连续的，因此我们可以通过所在的偏移来依次访问到所有的参数
首先：

1. int sum(int n, ...)
2. {
3.     va_list s;
4.     va_start(s, n);
5. }

复制代码

此中va_list现实上就是char*， 而va_start可以让s指向参数n的下一个参数，也就是可变参数的第一个参数的位置。此时我们就有了获取第一个参数内容的前提
这也是为什么printf等支持可变参数的函数中必须至少要有一个确定的参数，有了该参数才气找到可变参数的起始所在

1. int sum(int n, ...)
2. {
3.     va_list s;
4.     va_start(s, n);
6.     int sum = 0;
7.     while(n--)
8.     {
9.         sum += va_arg(s, int);
10.     }
11.     va_end(s);
12.     return sum;
13. }

复制代码

此中，va_arg传入s和可变参数的类型，用于提取s指向的参数，并且移动s到下一个参数的位置
va_end将s置为空
测试效果：

拓展问题：如果可变参数中，不同参数有不同的类型怎么办？
这也是为什么printf的第一个参数需要传入一个用于控制格式的字符串，通过遍历字符串就能知道可变参数中有哪些类型了

---

三、日志体系

本文实现的日志体系具备以下功能： 

• 包罗日志等级、日志时间、日志内容
  
• 将日志功能封装成类，并重载了函数调用运算符
  
• 可以选择将日志输出到终端、输出到同一文件或按照日志等级分类输出到不同文件
  
• 用户可自界说日志内容格式
  

如果要让日志包罗文件名和行号，则可以通过宏界说__FILE__和__LINE__获取文件名和行号
接下来是完备代码（附解释）

1. #pragma once
3. #include <iostream>
4. #include <time.h>
5. #include <unistd.h>
6. #include <sys/types.h>
7. #include <sys/stat.h>
8. #include <fcntl.h>
9. #include <stdarg.h>
11. // 日志等级
12. #define Info 0
13. #define Debug 1
14. #define Warning 2
15. #define Error 3
16. #define Fatal 4
18. #define SIZE 1024 // 缓冲区大小
20. // 日志的输出方式
21. #define Screen 1    // 输出到显示器
22. #define Same_file 2 // 输出到同一文件
23. #define Diff_file 3 // 按照等级输出到不同文件
25. #define Filename "log.txt"
27. class Log
28. {
29. public:
30.     Log()
31.     {
32.         _method = Screen; // 默认输出到显示器
33.     }
35.     void output(int method) // 更改输出方式
36.     {
37.         _method = method;
38.     }
40.     std::string level2string(int level) // 日志等级转换字符串
41.     {
42.         switch (level)
43.         {
44.         case Info:
45.             return "Info";
46.         case Debug:
47.             return "Debug";
48.         case Warning:
49.             return "Warning";
50.         case Error:
51.             return "Error";
52.         case Fatal:
53.             return "Fatal";
54.         default:
55.             return "None";
56.         }
57.     }
59.     void operator()(int level, const char *format, ...)
60.     {
61.         va_list s;
62.         va_start(s, format); // s指向可变参数
63.         messagehandle(level, format, s);
64.     }
66.     void messagehandle(int level, const char *format, va_list s) // 整合日志字符串
67.     {
68.         time_t t = time(nullptr);         // 获取时间戳
69.         struct tm *ctime = localtime(&t); // 将时间戳转换为时间
70.         char levelAndtime[SIZE];          // 日志等级和时间部分
71.         snprintf(levelAndtime, sizeof(levelAndtime), "[%s][%d-%d-%d %02d:%02d:%02d]", level2string(level).c_str(),
72.                  ctime->tm_year + 1900, ctime->tm_mon + 1, ctime->tm_mday, ctime->tm_hour, ctime->tm_min, ctime->tm_sec);
74.         char content[SIZE]; // 用户自定义的内容部分
75.         vsnprintf(content, sizeof(content), format, s);
76.         va_end(s);
78.         char message[SIZE * 2]; // 整合所有部分
79.         snprintf(message, sizeof(message), "%s %s\n", levelAndtime, content);
81.         OutputLog(level, message); // 将整合后的日志输出
82.     }
84.     void OutputLog(int level, const std::string &logmessage)
85.     {
86.         switch (_method) // 根据输出方式进行调整
87.         {
88.         case Screen: // 输出到显示器
89.             std::cout << logmessage << std::endl;
90.             break;
91.         case Same_file: // 输出到同一文件
92.             SamefileOutput(Filename, logmessage);
93.             break;
94.         case Diff_file: // 输出到不同文件
95.             DiffileOutput(level, logmessage);
96.             break;
97.         default:
98.             break;
99.         }
100.     }
102.     void SamefileOutput(const std::string &filename, const std::string &logmessage)
103.     {
104.         int fd = open(filename.c_str(), O_WRONLY | O_CREAT | O_APPEND, 0666); //打开文件
105.         if(fd < 0) //打开失败
106.             return;
107.         write(fd, logmessage.c_str(), logmessage.size()); //写入日志
108.         close(fd); //关闭文件描述符
109.     }
111.     void DiffileOutput(int level, const std::string &logmessage)
112.     {
113.         std::string filename = Filename;
114.         filename += ".";
115.         filename += level2string(level); //根据日志等级调整文件名
116.         SamefileOutput(filename, logmessage); //复用SamefileOutput函数
117.     }
119.     ~Log()
120.     {}
122. private:
123.     int _method; // 输出方式
124. };

复制代码

测试：
向显示器输出日志（n%5用于模拟不同日志等级）

向同一文件中输出日志

向不同文件中输出日志

完.

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。