学习面向对象(如C++编程语言),那么肯定了解析构函数,它在对象销毁的时候被调用,通常我们在构造函数中申请资源,在析构函数中释放资源。那么析构函数在实现以流方式输出日志中有什么妙用呢?接下来请让我一步步为你揭开这层迷雾。
C/C++语言日志输出模式一般有两种,一种类似printf的方式,另一种类似std::cout的方式,这里说的流方式输出日志指的就是类似std::cout的方式,并且自定义日志输出的格式,同时既可以将日志输出到终端,也可以将日志输出到文件。
printf("%s %d \n", "this is my log", 1);
std::cout << "this is my log " << 1 << std::endl;
一、格式化字符串的输出流
C++语言提供了ostringstream模版,它支持格式化字符串输出流。
首先让我们看看ostringstream的简单使用,定义ostringstream变量oss,然后将当前的线程id以十六进制的方式写入ostringstream变量, 再调用ostringstream的函数str(),将其转换为std::string字符串之后,打印输出到终端。
#include <sstream>
std::ostringstream oss;
oss << std::hex << std::this_thread::get_id();
LOG(INFO) << oss.str(
输出的信息如下所示,当前的线程id是以十六进制的格式输出。
[2019-11-30 22:03:50,124554] [bool JDebugCPPAttr::TestOstringstream():277] 0x7fff9e22c380
上面是ostringstream的简单使用方法,那么下面将说明如何构造输出函数名称和行号的字符串。通过利用系统提供的宏定义func和LINE来构造所需字符串信息。
std::ostringstream oss2;
oss2 << "[" << __func__ << ":" << __LINE__ << "]";
std::cout << oss2.str() << std::endl;
从输出的格式内容看,ostringstream按照预期的效果输出了正确的字符串格式。
[TestOstringstream:281]
二、资源获取即初始化
RAII全称是“Resource Acquisition is Initialization”,资源获取即初始化”,简单来说,就是说在构造函数中申请分配资源,在析构函数中释放资源。经常使用的方式是:构造函数中通过new申请内存,析构函数中通过delete释放内存。
基于RAII的思想,我们实现资源管理的管理类,管理类ResourceManager构造函数接受std::function类型的变量, 将其赋值给类的私有成员变量exit_handle,析构函数内调用exit_handle, 那么如果想要实现满足RAII, 那么只要构建释放资源的std::function类型的变量,然后传递给 ResourceManager。
class ResourceManager
{
public:
explicit ResourceManager(std::function<void()> fun):exit_handle(fun)
{
std::cout << "call constructor" << std::endl;
}
~ResourceManager()
{
std::cout << "call destructor " << std::endl;
exit_handle();
}
private:
std::function<void()> exit_handle;
};
申请创建内存,然后再创建ResourceManager对象,构造函数的入参是一个匿名函数,函数的功能是释放创建的内存。
{
int *p_data = new int();
ResourceManager( [&]()
{
std::cout << "delete p_data" << std::endl;
delete p_data;
});
}
运行程序之后,输出打印信息
call constructor
call destructor
delete p_data
同样的方式,我们可以创建文件之后,再创建ResourceManager对象,构造函数的参数功能是释放文件句柄。
{
std::ofstream ofs("test.txt");
ResourceManager( [&]
{
std::cout << "close ofs" << std::endl;
ofs.close();
});
}
运行程序之后,输出打印信息
call constructor
call destructor
close ofs
从上面的两个例子中,可以看出都是利用对象在销毁时会调用析构函数的原理来实现,简单来说,申请资源之后,紧接着设置释放资源,等到申请的资源使用完成之后,资源管理对象在退出作用域之后,就会调用析构函数来释放资源,这样做的好处是,我们不必关注资源什么时候进行释放的问题,同时一定程度上也防止忘记释放资源。
三、利用析构函数来实现日志输出
结合std::ostringstream可以格式化输出流的功能和对象销毁时调用析构函数的原理,我们就可以实现自定义格式,并以流方式输出日志的功能。
实现JWriter类来格式化日志信息并输出,这里我们只是简单输出到终端,当然,你也可以将自定义格式的日志信息写入文件或者写入队列,再由线程将队列中的日志信息写入文件。
JWriter类的构造函数接受三个参数:日志等级、函数名称、行号;并且重载了operator<<运算符
///类定义
class JWriter
{
public:
explicit JWriter(const std::string &strLevel, const std::string &strFun, int iLine);
~JWriter();
// 重载operator<<运算符
template <typename T>
inline JWriter& operator<<(const T& log) {
m_log << log;
return *this;
}
private:
std::string GetSysTimeToMs();
private:
std::ostringstream m_log;
};
///类实现
#include <iostream>
#include <thread>
#include <chrono>
#include <sys/timeb.h>
JWriter::JWriter(const std::string &strLevel, const std::string &strFun, int iLine)
{
m_log <<"["<< GetSysTimeToMs() << "]" << "[" << strFun << ":" << iLine << "]" << "[" << strLevel << "] ";
}
JWriter::~JWriter()
{
m_log << std::endl;
/// 这里可以实现将日志输出到终端或者写入文件
std::cout << m_log.str();
}
std::string JWriter::GetSysTimeToMs()
{
time_t timep;
struct timeb tb;
time (&timep);
char tmp[128] ={0};
strftime(tmp, sizeof(tmp), "%Y-%m-%d %H:%M:%S",localtime(&timep) );
char tmp2[128] ={0};
ftime(&tb);
snprintf(tmp2,sizeof(tmp2),"%d",tb.millitm);
std::ostringstream buffer;
buffer << tmp << "." << tmp2 ;
return buffer.str();
}
那么如何来使用JWriter类,使用效果又是怎样呢?其实很简单,定义如下所示的宏,该宏只接受日志等级的字符串参数。
#define MyLogJ(LEVEL) JWriter(LEVEL, __func__, __LINE__)
调用方式如下所示,它跟我们熟悉使用的std::cout的方式是一样一样的,只是std::cout换成了我们实现的MyLogJ()宏,因此,不存在需要花费时间来学习它的使用的问题。
MyLogJ("INFO") << "hello " << 123;
MyLogJ("INFO") << "hello " << " world";
如下所示输出的效果,它首先输出日期时间,然后是函数名和对应行号以及日志等级,最后才输出用户输入的日志信息。这样的格式,通常是比较美观,并且利于问题的定位,当然,你也可以根据个人的喜好来修改JWriter的构造函数来自定义自己的日志格式。
[2019-12-01 10:26:00.657][TestMyLog:266][INFO] hello 123
[2019-12-01 10:26:00.657][TestMyLog:267][INFO] hello world
四、总结
自定义日志格式并以流方式输出的功能已经介绍结束,它是利用了std::ostringstream可以格式化输出流的功能,并且在构造函数格式日志信息,析构函数最后处理日志信息,同时重载了operator<<运算符。
析构函数不只是用于释放资源,我们可以利用它的特性来做其他的运用,就如本文介绍的一样,利用了析构函数实现了流方式的日志功能,如果没有,单纯利用构造函数很难实现流方式的日志功能。当然,析构函数可能还有其他妙用,这需要我们不断去发掘。