超级好用的C++实用库之日志类

💡 需要该C++实用库源码的大佬们，可搜索微信公众号“希望睿智”。添加关注后，输入消息“超级好用的C++实用库”，即可获得源码的下载链接。

概述

日志类主要用于在程序运行过程中记录信息、错误、警告以及其他需要跟踪的数据，这对于调试、监控应用状态及后期问题分析至关重要。一个高效且灵活的日志类应该满足以下几个核心需求。

日志级别管理：可定义多个日志级别，比如：DEBUG、INFO、WARN、ERROR、FATAL等，以便根据情况筛选日志的详细程度。同时，还允许运行时动态调整日志输出级别，便于在生产环境中减少不需要的日志输出，或增加更详细的日志输出。

多线程安全：在多线程的环境下，可确保日志写入操作是线程安全的，避免日志内容混乱或程序崩溃。通常情况下，这可以通过互斥锁、原子操作或线程局部存储等机制来实现。

灵活的输出点：支持将日志输出到控制台、本地文件、网络套接字、数据库等多种目的地，并可配置输出目标，允许同时或选择性地输出到多个地方。

自动文件管理：可自动创建和管理日志文件，并按时间、大小滚动日志文件。同时，文件名应包含日期等信息，便于归档和查询。

日志格式化：支持格式化字符串，允许在日志中内嵌变量、时间戳、进程ID、线程ID等信息。另外，支持自定义日志格式，以满足不同场景下的需求。

高性能与低延迟：采用缓冲机制减少I/O操作次数，提高日志写入效率。支持异步写入日志，避免阻塞主线程，减少对应用性能的影响。

可以看到，封装一个高效且灵活的日志类，需要考虑的东西非常多。目前有很多第三方开源日志库，比如：glog、spdlog或EasyLogger等，但这些库用起来相对比较复杂，特别是在底层模块中使用，耦合比较严重。为了简化底层模块中日志类的使用，我们封装了下面的CHP_Logger类。

CHP_Logger类

CHP_Logger是一个简单、易于集成和使用的日志类，可在各个底层库中使用。应用层可使用glog、spdlog或EasyLogger等第三方日志库，并配合该日志类记录底层库日志。CHP_Logger类的头文件，可参考下面的示例代码。

#pragma once#include <stdarg.h>#include "HP_Types.h"
#include "HP_Mutex.h"enum IHPLoggerLevel
{HPLoggerLevel_None,HPLoggerLevel_Error, HPLoggerLevel_Warn,HPLoggerLevel_Info, HPLoggerLevel_Debug, HPLoggerLevel_Trace, HPLoggerLevel_Count
};typedef void(*CALLBACK_LOGGER_OUTPUT)(IHPLoggerLevel level, const char *pszLog, void *pContext);class CHP_Logger
{
public:static void Open();static CHP_Logger *&Singleton();static void Close();void SetLevel(IHPLoggerLevel level);bool IsLogEnabled(IHPLoggerLevel level);void SetLogOutputListener(CALLBACK_LOGGER_OUTPUT pCbOutput, void *pContext);void SetMaxLogLen(unsigned int uiLen);void Error(const char *pszFormat, ...);void Warn(const char *pszFormat, ...);void Info(const char *pszFormat, ...);void Debug(const char *pszFormat, ...);void Trace(const char *pszFormat, ...);static void Error(CHP_Logger *pLogger, const char *pszFormat, ...);static void Warn(CHP_Logger *pLogger, const char *pszFormat, ...);static void Info(CHP_Logger *pLogger, const char *pszFormat, ...);static void Debug(CHP_Logger *pLogger, const char *pszFormat, ...);static void Trace(CHP_Logger *pLogger, const char *pszFormat, ...);protected:CHP_Logger();~CHP_Logger();private:void Log(const char *pszFormat, va_list &argList, IHPLoggerLevel level);private:static CHP_Logger *m_pThis;IHPLoggerLevel m_level;CALLBACK_LOGGER_OUTPUT m_pCbOutput;void *m_pContext;char *m_pszLog;unsigned int m_uiMaxLogLen;CHP_Mutex m_mutexLog;
};

在上面的示例代码中，我们声明了一个枚举类型IHPLoggerLevel，用于指定日志输出级别。CHP_Logger类是一个接口类，不需要实例化。因此，我们将构造函数和析构函数声明成了私有的。下面，我们将分别介绍其导出的公共实例接口。

SetLevel：设置日志输出级别。参数level为日志输出级别，用于控制日志输出的详细程度。

IsLogEnabled：用于判断指定级别的日志是否使能。参数level为指定的日志级别，返回值为true表示该级别的日志使能，否则不使能。

SetLogOutputListener：设置日志输出监听器。参数pCbOutput为日志输出的回调函数，参数pContext为回调函数上下文。应用层需要设置日志输出监听器，以对回调函数中的日志进行自定义操作，比如：写本地文件、输出到控制台、传输到网络等。

SetMaxLogLen：设置单条日志的最大长度。参数uiLen为单条日志的最大长度，单位为字节，传0时，默认为16KB。

Error：输出错误日志。pszFormat为日志格式字符串，支持可变参数。

Warn：输出警告日志。pszFormat为日志格式字符串，支持可变参数。

Info：输出信息日志。pszFormat为日志格式字符串，支持可变参数。

Debug：输出调试日志。pszFormat为日志格式字符串，支持可变参数。

Trace：输出详尽日志。pszFormat为日志格式字符串，支持可变参数。

除了上面的实例接口外，我们还导出了5个同名的静态接口，分别为：Error、Warn、Info、Debug、Trace。这几个静态接口一般用于底层动态链接库中输出日志，这样底层和应用层可以共用一个日志单实例对象。