Lib.rs

用于Windows调试器的日志记录器。

Windows允许应用程序直接向调试器输出字符串。在其他日志形式不可用的情况下，这非常有用。例如，对于GUI应用程序，stderr不可用。

Windows提供了OutputDebugString入口点，允许应用程序打印调试字符串。在内部，OutputDebugString通过引发SEH异常来实现，调试器捕获并处理这个异常。

在调试器下运行时，引发异常有显著的代价，因为调试器会暂停目标进程中的所有线程。因此，你应该避免在高输出率的情况下使用此日志记录器，因为这样做会减慢你的应用程序。

类似于许多Windows入口点，OutputDebugString实际上是两个入口点：OutputDebugStringA（多字节编码）和OutputDebugStringW（UTF-16）。在大多数情况下，*A版本是通过一个“thunk”实现的，该“thunk”将其参数转换为UTF-16，然后调用*W版本。然而，OutputDebugStringA是少数几个反其道而行之的入口点之一。

此crate可以在非Windows平台上编译和使用，但它不执行任何操作。这是为了最小化对依赖于此crate的代码的影响。