zlog 1.2新特性：管道支持与全面日志转档

"zlog 使用教程" 本文档详细介绍了开源日志库zlog的使用方法，主要涵盖其1.2版本的新特性以及基本操作。zlog是一个面向C语言开发的、高性能、线程安全的日志库，它弥补了C语言中缺乏强大日志处理库的空白，提供了类似于log4j的灵活性。 ### 兼容性说明 zlog基于POSIX标准，已在AIX和Linux系统上测试通过，预计能在其他如FreeBSD、NetBSD、OpenBSD、OpenSolaris和Mac OS X等系统上运行。zlog依赖于C99兼容的`vsnprintf`函数，该函数在缓存不足时返回字符串预期长度，而非-1。如果遇到不兼容的`vsnprintf`实现，用户可能需要自行安装符合C99标准的版本，如ctrio或C99-snprintf，并修改`buf.c`文件。 ### zlog 1.2 发布说明 - **新功能**：支持管道输出，允许连接到像cronolog这样的日志过滤程序；全面的日志转档功能；以及其他兼容性改进。 - **二进制兼容性**：zlog 1.2与1.0/1.1版本在库层面是二进制兼容的，但所有宏名已由大写改为小写，例如`ZLOG_INFO`变为`zlog_info`。如果要升级，用户需编写脚本批量替换源代码中的大写宏为小写，再重新编译程序。 ### 使用教程 - **Hello World**：文档包含了zlog的编译、安装步骤，以及简单的示例代码，展示如何在应用程序中引入和使用zlog。 - **Syslog模型**：zlog基于syslog模型，介绍分类、规则和格式的概念，以及与log4j模型的区别，并提供扩展syslog模型的方法。 - **配置文件**：详述了配置文件的结构，包括全局参数、日志等级自定义、格式、转换格式串和规则等，以及文件转档和配置文件工具的使用。 - **接口(API)**：详细阐述了zlog的初始化、分类操作、写日志函数、MDC操作、dzlog接口、用户自定义输出和调试诊断等功能。 - **高阶使用**：讲解了MDC的高级使用、zlog自身的诊断、用户自定义等级和输出的实现。 zlog提供了一套完整的日志管理解决方案，从基本的日志记录到复杂的日志配置和转档，为C语言开发者提供了便利。通过学习和应用zlog，开发者可以更高效地管理和调试他们的应用程序日志，同时确保日志的可读性和可靠性。