Boost C++ 库

如今，应用程序发展迅速，变得复杂且难以测试和调试。大多数时候，应用程序运行在远程站点，开发者很难监控其执行情况，一旦出现问题也难以找出失败的原因。此外，即使是本地调试也可能变得困难，因为应用程序的行为高度依赖于异步的外部事件，例如设备反馈或其他进程的活动。

这就是日志记录可以发挥作用的地方。应用程序将其所有关键执行信息存储到日志中，当出现问题时，这些信息可以用来分析程序行为并进行必要的修正。日志记录还有其他非常有用的应用，例如收集统计信息和高亮事件（即指示某些情况的发生，或应用程序正在经历某些问题）。这些任务对许多真实世界的工业应用已被证明至关重要。

本库旨在显著简化应用程序开发者的日志记录工作。它提供了广泛的开箱即用工具，以及用于扩展本库的公共接口。本库的主要目标是：

本文档面向新老用户。但是，用户应熟悉常用的 Boost 组件，如 shared_ptr、make_shared（参见 Boost.SmartPtr）以及 function（Boost.Function）。本文档的某些部分将在需要时引用其他 Boost 库。

如果您是第一次使用本库，建议阅读 设计概述 部分，以初步了解本库的功能和架构。安装和教程部分将帮助您开始尝试使用本库。教程通过示例代码片段概述了本库的功能。某些教程步骤以两种形式呈现：简单和高级。简单形式通常描述了完成任务最常见和最简单的方法，建议新用户阅读。高级形式通常提供了一种扩展的方式来完成同一件事，但有深入的解释和进行一些额外自定义的能力。这种形式对于更有经验的用户可能很有用，如果简单的方法不能满足您的需求，通常应该阅读。

除了教程，还有一个详细特性描述章节。本节描述了教程未涵盖的其他由本库提供的工具。本章最好逐个阅读。

最后但同样重要的是，有一个参考部分，提供了本库组件接口的正式描述。

为了使本文档中的代码片段保持简洁，假定定义了以下命名空间别名：

namespace logging = boost::log;
namespace sinks = boost::log::sinks;
namespace src = boost::log::sources;
namespace expr = boost::log::expressions;
namespace attrs = boost::log::attributes;
namespace keywords = boost::log::keywords;

请注意，大多数示例都附带一个指向完整可编译代码样本的链接，其中包含所有必要的包含文件和辅助代码（如果有什么被从文档中省略了）。相关包含文件也在各节的开头列出。

以下是一些将在本文档中广泛使用的术语的定义：