spdlog源码阅读 (1): sinks

0. spdlog简单介绍

spdlog 是一个快速的 C++ 日志库，只包含头文件，兼容 C++11。项目地址

特性:

• 非常快
• 只包含头文件
• 无需依赖第三方库
• 支持跨平台 - Linux / Windows on 32/64 bits
• 支持多线程
• 可对日志文件进行循环输出
• 可每日生成日志文件
• 支持控制台日志输出
• 可选的异步日志
• 支持日志输出级别
• 可自定义日志格式
  
  (上述内容来源于 开源中国关于spdlog的介绍)

1. sinks

在spdlog中，sink指向实际的输出目标，例如

1. stdout
2. syslog(linux系统日志)
3. ostream
4. file
5. ...
   
   代码路径: spdlog-master/include/spdlog/sinks

1.1 sink

class sink
{
public:sink(){_level = level::trace;}virtual ~sink() {}virtual void log(const details::log_msg& msg) = 0;virtual void flush() = 0;bool should_log(level::level_enum msg_level) const;void set_level(level::level_enum log_level);level::level_enum level() const;private:level_t _level;
};

sink类的两个纯虚函数 log flush 是子类需要实现的接口。

1.2 base_sink

没啥好说的直接上代码，这里仅列出主要内容。

template
class base_sink:public sink
{
public://.....void log(const details::log_msg& msg) override{std::lock_guard lock(_mutex);_sink_it(msg);}protected:virtual void _sink_it(const details::log_msg& msg) = 0;Mutex _mutex;
};

模板类**base_sink继承sink，同时实现了log接口，通过Mutex决定类是工作在单线程

还是多线程下。而子类通过实现接口_sink_it输出日志。

在spdlog中，如果在多线程中base_sink形式如下：base_sink;
单线程：base_sink;

而null_mutex什么都不做。

1.3 rotating_file_sink

通过文件饶接这个例子看下在spdlog中具体的sink是怎么实现的。

template
class rotating_file_sink : public base_sink < Mutex >
{
public://......
protected:void _sink_it(const details::log_msg& msg) override{_current_size += msg.formatted.size();if (_current_size > _max_size){_rotate();_current_size = msg.formatted.size();}_file_helper.write(msg);}private://......void _rotate(){for (auto i = _max_files; i > 0; --i){// 修改文件名，转储文件//......}//......
};
typedef rotating_file_sink rotating_file_sink_mt;
typedef rotating_file_sinkrotating_file_sink_st;

_sink_it实现了在文件超过限制后通过_rotate转储文件，同时使用文件进行输出。输出的对象是msg(

实际的日志内容)。

代码的最后两行分别定义了rotating_file_sink_mt和rotating_file_sink_st。前者使用在多线程中，

后者使用在单线程。其中的区别在1.2中已经说明。