easylogging++的那些事(二)宏定义

上一篇文章我们简要介绍了 easylogging++的 主要功能。easylogging++中有很多特性是通过宏来控制的，今天我们就来聊聊这些宏：

  1. debug 输出流宏定义
    ELPP_INTERNAL_DEBUGGING_OUT_INFO(目前相当于 std:: cout)
    ELPP_INTERNAL_DEBUGGING_OUT_ERROR(目前相当于 std:: cerr)
    ELPP_INTERNAL_DEBUGGING_ENDL(目前相当于 std:: endl)

  2. 字符串包装宏 ELPP_INTERNAL_DEBUGGING_MSG（目前就是字符串本身）

  3. 断言宏
    ELPP_DISABLE_ASSERT(禁用断言)
    ELPP_DEBUG_ASSERT_FAILURE(断言条件失败时，程序停止在断言处不继续往下执行)

  4. errno 错误输出宏 ELPP_INTERNAL_DEBUGGING_WRITE_PERROR

  5. 详细错误信息调试宏（会输出自定义错误信息加上 errno 错误信息 ELPP_INTERNAL_DEBUGGING_WRITE_PERROR）
    ELPP_DEBUG_ERRORS 启用宏
    ELPP_INTERNAL_ERROR 调试详细错误信息输出宏

  6. INFO 调试日志宏 调试源码时输出内部的 INFO 日志信息
    ELPP_DEBUG_INFO
    ELPP_INTERNAL_INFO_LEVEL(默认最大 info 级别设为 9)

  7. CRASH 堆栈日志宏( 仅仅支持 GCC )
    开启宏: ELPP_FEATURE_ALL 或者 ELPP_FEATURE_CRASH_LOG
    STACKTRACE 宏: ELPP_STACKTRACE

  8. 杂项宏
    ELPP_UNUSED 指示未使用的变量或者参数
    ELPP_LOG_PERMSlinux 文件权限宏
    ELPP_AS_DLL ELPP_EXPORT_SYMBOLSwindows dll 导入导出宏
    STRTOK STRERROR STRCAT STRCPY常见字符串库函数宏
    ELPP_NO_SLEEP_FOR 当前平台是否支持 sleep 库函数
    ELPP_UTC_DATETIME当前时间函数宏(默认使用本地时间相关函数，定义后，使用 UTC 时间相关函数)

  9. 启用标准线程库宏
    ELPP_FORCE_USE_STD_THREAD 强制使用标准库的线程接口(内部会测试系统信息是否支持)

  10. 异步日志宏 ELPP_EXPERIMENTAL_ASYNC

  11. 线程安全宏 ELPP_THREAD_SAFE 或 ELPP_EXPERIMENTAL_ASYNC

  12. 函数签名宏 ELPP_FUNC

  13. 可变参模板支持条件测试宏 ELPP_VARIADIC_TEMPLATES_SUPPORTED

  14. 日志启用相关宏
    禁用全部日志 ELPP_DISABLE_LOGS( 日志输出的前提 )
    单独禁用 DEBUG 日志 ELPP_DISABLE_DEBUG_LOGS
    单独禁用 INFO 日志 ELPP_DISABLE_INFO_LOGS
    单独禁用 WARNING 日志 ELPP_DISABLE_WARNING_LOGS
    单独禁用 ERROR 日志 ELPP_DISABLE_ERROR_LOGS
    单独禁用 FATAL 日志 ELPP_DISABLE_FATAL_LOGS
    单独禁用 TRACE 日志 ELPP_DISABLE_TRACE_LOGS
    单独禁用 VERBOSE 日志 ELPP_DISABLE_VERBOSE_LOGS

  15. STL 相关容器日志直接输出支持相关宏
    所有 STL 容器都需要: ELPP_STL_LOGGING
    array 需要：ELPP_LOG_STD_ARRAY
    unordered_set 需要：ELPP_LOG_UNORDERED_SET

  16. QT 相关容器日志直接输出支持相关宏 ELPP_QT_LOGGING

  17. BOOST 相关容器日志直接输出支持相关宏 ELPP_BOOST_LOGGING

  18. WXWIDGETS 相关类日志直接输出支持相关宏 ELPP_WXWIDGETS_LOGGING

  19. unicode 支持宏 ELPP_UNICODE

  20. 默认日志记录器 id 宏(不指定时为 default) ELPP_DEFAULT_LOGGER

  21. 性能跟踪宏：ELPP_FEATURE_PERFORMANCE_TRACKING

  22. 默认性能跟踪日志记录器 id 宏(不指定时为 performance) ELPP_DEFAULT_PERFORMANCE_LOGGER

  23. 全部特性开启宏(主要用于性能跟踪和 crash 堆栈记录) ELPP_FEATURE_ALL

  24. syslog 日志开启宏(需要系统支持 syslog 日志， 默认 syslog 的日志记录器 id 为 syslog) ELPP_SYSLOG

  25. MAKE_LOGGABLE用于兼容无法修改源码的第三方类型也能直接进行日志输出

  26. 性能跟踪宏
    TIMED_SCOPE_IF
    TIMED_SCOPE
    TIMED_BLOCK
    TIMED_FUNC_IF
    TIMED_FUNC
    PERFORMANCE_CHECKPOINT
    PERFORMANCE_CHECKPOINT_WITH_ID

  27. 指定文件指定行计数器(用于条件记录日志)
    ELPP_COUNTER
    ELPP_COUNTER_POS

  28. 写日志相关宏（easylogging++的哪些事(一): 功能介绍 中仔细介绍过)

  29. 宏技巧：
    获取可变参的数量: el_resolveVALength( 目前源码当中最多只能获取的可变参数量限制在 10 个 )

easylogging++当中的宏就介绍到这里，下一篇文章将开始介绍 easylogging++的总体框架。

标签 , ,