http://0xc0.de/LibComponentLogging
http://github.com/aharren/LibComponentLogging-qlog

概述

qlog -- LibComponentLogging 的一套快速日志宏。

qlog 只是一个小的头文件，为 LibComponentLogging 的每个日志级别定义了一个简短的日志宏，例如，qlerror() 用于错误消息，qltrace() 用于跟踪消息。此外，所有日志宏都接受来自 ql_component 预处理器定义的当前日志组件，该定义可以在您的应用程序的文件级、基于节段或全局范围内（重新）定义。如果您想将日志组件包含在您的日志语句中，而不是使用 ql_component 定义，则可以使用 Logging 宏的 _c 变体，它们将日志组件作为第一个参数，例如 qlerror_c(lcl_cMain)，qltrace_c(lcl_cMain, @"message")。

用法

要安装 qlog，只需将 qlog.h 头文件复制到您的项目中，并将 qlog.h 的导入添加到您的 preheader 文件或 LibComponentLogging 扩展配置文件中，例如：

//
// lcl_config_extensions.h
//
...
#import "qlog.h"
...

然后，在全局范围内定义预处理器符号 ql_component，用您的默认日志组件，例如，在您的 preheader 文件中添加一个定义：

#define ql_component lcl_cDefaultLogComponent

现在，您可以通过使用 qlog 宏而不是 LibComponentLogging 的 lcl_log 宏来简单地将日志语句添加到您的应用程序中

qlinfo(@"initialized");
qlerror(@"file '%@' does not exist", file);
qltrace();

所有这些日志语句都将使用来自 ql_component 定义的字段，可以在日志语句的位置看到。

如果您想为文件中的所有日志语句使用特定的日志组件，您可以简单地重定义 ql_component 以匹配该日志组件，例如，通过在每个文件的顶部添加 #undef #define 序列，例如：

#undef ql_component
#define ql_component lcl_cFileLevelComponent

如果您想在代码的特定位置使用特定的日志组件，则可以使用宏的 _c 变体，它们将日志组件作为第一个参数，例如：

qlinfo_c(lcl_cMain, @"initialized");
qlerror_c(lcl_cMain, @"file '%@' does not exist", file);
qltrace_c(lcl_cMain);

相关仓库

以下 Git 仓库与该仓库相关

• http://github.com/aharren/LibComponentLogging-Core：LibComponentLogging 的核心文件。

版权和许可协议

版权（c）2009-2012 Arne Harren [email protected]

本文件特此授予任何人，免费使用并获得本软件和相关文档文件（“软件”）的副本的权利，可在没有任何限制的情况下处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可以及/或销售软件副本，并允许向软件提供者提供软件以进行上述操作，但需遵守以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“现状”提供，不提供任何形式的保证，无论是明示还是默示，包括但不限于商业性、适用于特定目的和非侵权性保证。在任何情况下，作者或版权持有人在合同、侵权或其他诉讼中，均不对任何索赔、损害或其他责任承担责任，无论源于、源于或与软件、软件的使用或其他处理有关。