专栏首页10km的专栏C++11:模板函数实现支持变长参数的简单日志输出

C++11:模板函数实现支持变长参数的简单日志输出

版权声明:本文为博主原创文章,转载请注明源地址。 https://blog.csdn.net/10km/article/details/80216226

开源的世界,现成的轮子很多,但如果现成的轮子太重太复杂,有的时候也不妨自己发明个轻便的轮子用起来更趁手。

经常我们在程序中需要打调试信息或普通的屏幕输出,大多情况情况下,用printf就可以将就了,但printf用志来也不是太方便: 需要为不同的参数类型指定不同的输出格式(%s,%d....),错了还不行,好麻烦,为了调试方便需要在文件名和行号,printf可做不到这个。 我们知道,log4cpp,glog都为C++程序提供了强大的日志输出功能,能实现远远超上面的很多功能,但是有的时候我真的不需要这么强的日志输出,而且引入这些第三方库也要折腾一阵子,如果程序要支持跨平台编译,设置还要复杂一些。

为了解决这个问题,我想到基于C++11的变长参数模板,自己实现一个简单的控制台信息输出功能。 关于变长参数模板,现在也有不少入门的文章介绍,不了解概念的童鞋可以搜索一下,随便找一篇供参考:

《使用C++11变长参数模板 处理任意长度、类型之参数实例》

变长模板、变长参数C++11提供的新特性,利用变长参数模板,可以处理任意长度、类型的参数实例。有这个语言特性的帮助,就可以像java语言一样,定义可以接收任意长度不同类型的参数的函数。

sample_log.h

#ifndef COMMON_SOURCE_CPP_SAMPLE_LOG_H_
#define COMMON_SOURCE_CPP_SAMPLE_LOG_H_
#include <string>
#include <vector>
#include <mutex>
#include <regex>
#include <iostream>
#include <type_traits>
#include "string_utils.h"
namespace gdface {
    namespace log {
        // 模板函数,将value输出到stream
        // 非指针类型参数实现
        template<typename E,
            typename TR = std::char_traits<E>,
            typename T>
        typename std::enable_if<!std::is_pointer<T>::value>::type
            _value_output_stream(std::basic_ostream<E, TR>& stream, const T& value) {
            stream << value;
        }
        // 模板函数,将value输出到stream
        // 指针类型参数实现,value为null时输出字符串‘null’
        template<typename E,
            typename TR = std::char_traits<E>, 
            typename T>
        typename std::enable_if<std::is_pointer<T>::value>::type
            _value_output_stream(std::basic_ostream<E, TR>& stream, const T& value) {
            // 为 null的指针输出 字符串'null'
            if (nullptr == value) {
                stream << "null";
            }
            else {
                stream << value;
            }
        }
        // 特化函数
        // 当value为string时转为wstring输出到wostream
        inline void _value_output_stream(std::wostream&stream, const std::string& value) {
            stream << to_wide_string(value);
        }
        // 特化函数
        // 当value为wstring时转为string输出到ostream
        inline void _value_output_stream(std::ostream&stream, const std::wstring& value) {
            stream << to_byte_string(value);
        }
        // 特化函数
        // 当value为wchar_t*时转为string输出到ostream
        inline void _value_output_stream(std::ostream&stream, const wchar_t* value) {
            if (nullptr == value) {
                stream << "null";
            }
            else {
                stream << to_byte_string(value);
            }
        }
        /* 终止递归函数 */
        template<typename E,
            typename TR = std::char_traits<E>,
            typename AL = std::allocator<E>>
        void _sm_log_output(std::basic_ostream<E, TR>& stream, const std::vector<std::basic_string<E, TR, AL>>& format, int& idx) {
        }
        // 模板递归处理可变参数,每次处理一个参数
        // T 为第一个参数类型
        template<typename E,
            typename TR = std::char_traits<E>,
            typename AL = std::allocator<E>,
            typename T, typename ...Args>
        typename void _sm_log_output(std::basic_ostream<E, TR>& stream, const std::vector<std::basic_string<E, TR, AL>>& format, int& idx, const T& first, Args...rest) {
            if (idx < format.size()) {
                _value_output_stream(stream, format[idx]);
                if (idx < format.size() - 1) {
                    _value_output_stream(stream, first);
                }
                _sm_log_output(stream, format, ++idx, rest...);
            }
        }
        // 调用递归模板函数_sm_log_output 输出所有可变参数
        // E为基本元素数据类型,支持char,wchar_t,
        // 对应的stream支持ostream,wostream,fromat支持string,wstring
        template<typename E,
            typename TR = std::char_traits<E>,
            typename AL = std::allocator<E>,
            typename _str_type = std::basic_string<E, TR, AL>,
            typename ...Args>
        void sm_log(std::basic_ostream<E, TR>& stream, const char* file, int line, const std::basic_string<E, TR, AL>& format, Args...args) {
            const static std::string delim("{}");
            static std::once_flag oc;
            std::call_once(oc, [] {
#ifdef _MSC_VER
                std::locale loc(std::locale(), "", LC_CTYPE);
                std::wcout.imbue(loc);
                std::wcerr.imbue(loc);
                std::wclog.imbue(loc);
#elif defined(__GNUC__)
                std::locale::global(std::locale(""));
#endif
            });
            // {}为占位符
            auto vf = split(format, std::string("\\{\\}"));
            if (end_with(format, delim)) {
                // 末尾插入空字符串
                vf.push_back(_str_type());
            }
            std::string fn(file);
            auto pos = fn.find_last_of("\\/");
            // 只显示文件名
            int index = 0;
            stream << "[" << (pos != std::string::npos ? fn.substr(pos + 1) : fn).c_str() << ":" << line << "]:";
            // 调用递归模板函数
            _sm_log_output(stream, vf, index, args...);
            // 输入参数 少于占位符数目,则原样输出格式化字符串
            for (; index < vf.size(); ++index) {
                stream << vf[index];
                if (index < vf.size() - 1) {
                    stream << "{}";
                }
            }
            stream << std::endl;
        }
        // 局部特化函数
        // 当format为指针类型时,转为wstring或string
        template<typename E,
            typename TR = std::char_traits<E>,
            typename AL = std::allocator<E>,
            typename ...Args>
            void sm_log(std::basic_ostream<E, TR>& stream, const char* file, int line, const E* format, Args...args) {
            sm_log(stream, file, line, std::basic_string<E, TR, AL>(format), args...);
        }
        // 局部特化函数,
        // 当format为string类型而stream为wostream类型时,将format转为wstring
        template<typename ...Args>
            void sm_log(std::wostream& stream, const char* file, int line, const char* format, Args...args) {
            sm_log(stream, file, line, to_wide_string(format), args...);
        }
    } /* namespace log */
// 定义使用 ostream 还是 wostream作为输出流
// 默认使用 wostream 输出,以确保宽字符集信息(如中文)可正确显示
#ifdef _SL_USE_BYTE_STREAM
#define __SL_STREAM_OUT__ std::cout
#define __SL_STREAM_ERR__ std::cerr
#define __SL_STREAM_LOG__ std::clog
#else
#define __SL_STREAM_OUT__ std::wcout
#define __SL_STREAM_ERR__ std::wcerr
#define __SL_STREAM_LOG__ std::wclog
#endif

#define SAMPLE_LOG_STREAM(stream,format,...) gdface::log::sm_log(stream,__FILE__,__LINE__,format, ##__VA_ARGS__)

// 向std::cout输出带文件名和行号的信息,{}为占位符,调用示例
// SAMPLE_LOG("hello,{} {}","world",2018);
// 输出:hello,world 2018
// NOTE:
// 因为gdface::log::sm_log函数中调用了std::call_once函数,
// 所以在linux下编译时务必要加 -lpthread 选项,否则运行时会抛出异常:
// terminate called after throwing an instance of 'std::system_error'
//      what() : Unknown error - 1
#define SAMPLE_OUT(format,...)  SAMPLE_LOG_STREAM(__SL_STREAM_OUT__,format, ##__VA_ARGS__)
#define SAMPLE_ERR(format,...)  SAMPLE_LOG_STREAM(__SL_STREAM_ERR__,format, ##__VA_ARGS__)
#define SAMPLE_LOG(format,...)  SAMPLE_LOG_STREAM(__SL_STREAM_LOG__,format, ##__VA_ARGS__)

} /* namespace gdface */
#endif /* COMMON_SOURCE_CPP_SAMPLE_LOG_H_ */

完整代码参见gitee仓库: https://gitee.com/l0km/common_source_cpp/blob/master/sample_log.h 上面代码#include "string_utils.h"的文件在gitee仓库地址: https://gitee.com/l0km/common_source_cpp/blob/master/string_utils.h

调用示例

上面的实现代码有一百多行,真正供我们调用的其实就是最后定义的三个宏SAMPLE_OUT,SAMPLE_ERR,SAMPLE_LOG,用法类似于log4j。如下:

#include "sample_log.h"
int main() {
    const wchar_t * wcp = L"[char pointer汉字]";
    double pi = 3.14159265358979323846;
    // string,wstring,pointer,number类型测试
    SAMPLE_OUT("{}std::wcout输出测试 wchar_t*:{} pointer = {} double:{} chinese char*:{}", "hello,", wcp, &pi, pi,"error程序猿");
    // 当输入参数多于{} 占位符时,多余的参数不显示
    SAMPLE_OUT("{}std::wcout输出测试 wchar_t*:{} ", "hello,", wcp, &pi, pi);
    // 当输入参数少于{} 占位符时,显示多余的占位符
    SAMPLE_OUT("{}std::wcout输出测试 wchar_t*:{} pointer = {} double:{} chinese char*:{}", "hello,", wcp);
    SAMPLE_OUT("ERROR: {}", "std::wcerr输出测试");
    SAMPLE_LOG("LOG: {}", "std::wclog输出测试");
}

windows下输出:

linux下输出

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • C++11:变长参数模板模拟java.lang.String.format格式化输出

    版权声明:本文为博主原创文章,转载请注明源地址。 https://blog.csdn.net...

    用户1148648
  • c++11:基于STL实现字符串分割更简单 wstring,string split

    版权声明:本文为博主原创文章,转载请注明源地址。 https://blog.csdn.net...

    用户1148648
  • c++11模板:容器(map,set,list,vector)中元素类型转换

    版权声明:本文为博主原创文章,转载请注明源地址。 https://blog.csdn.net...

    用户1148648
  • python-numpy

    Dean0731
  • 数据驱动的社交媒体营销怎么玩?

    互联网时代,社交媒体扮演了直接触达到用户的重要角色,数据也赋予了社交媒体营销新动能。准确的用户画像从何而来?对标竞品的特点有哪些?真正打动消费者的KOL是谁?这...

    DT数据侠
  • spring boot 获取 request

    如此使用可能会造成空指针异常,所以建议添加Objects.requireNonNull,如果为空,抛出异常。

    一个会写诗的程序员
  • 你最常用那种编程语言

    随着技术的进步,科技的发展,出现了越来越多的编程语言,那么作为一个嵌入式攻城狮来说,会几种才能够适应呢,其实没有标准的答案,像最早我们学习汇编语...

    用户1605515
  • 如何口述机器学习模型原理

    作者:Ricky翘 zhuanlan.zhihu.com/p/34128571 有时碰到跟别人聊起模型的熟悉时,不免要阐述下模型的原理,但一般口头交流都比较难...

    统计学家
  • Spring 5.0.3.RELEASE中的 Kotlin 语言等支持Spring 5.0.3.RELEASE中的 Kotlin 语言支持

    https://docs.spring.io/spring/docs/current/spring-framework-reference/languages....

    一个会写诗的程序员
  • C#版 - Leetcode 65. 有效数字 - 题解

    在线提交: Leetcode https://leetcode.com/problems/valid-number/

    Enjoy233

扫码关注云+社区

领取腾讯云代金券