Share via

_RPT, _RPTF, _RPTW, _RPTFW宏

  • 项目

通过生成调试报告跟踪应用程序的进程（仅限调试版本）。 n后缀指定args中的参数个数，它可以是 0、1、2、3、4 或 5。

语法

_RPTn(
   reportType,
   format,
   ...[args]
);
_RPTFn(
   reportType,
   format,
   [args]
);
_RPTWn(
   reportType,
   format
   [args]
);
_RPTFWn(
   reportType,
   format
   [args]
);

参数

reportType
报告类型：_CRT_WARN、_CRT_ERROR 或 _CRT_ASSERT。

format
用于创建用户消息的格式控件字符串。

args
由 format 使用的替换参数。

注解

所有这些宏都采用reportType和format参数。 此外，它们还可能需最多四个附加参数，由追加到宏名称的数字表示。 例如，_RPT0和_RPTF0不采用更多参数，_RPT1和_RPTF1采用arg1，_RPT2和_RPTF2采用arg1和arg2等。

_RPT和_RPTF宏类似于printf函数，因为它们可用于跟踪调试过程中的应用程序的进度。 不过，这些宏比printf更灵活，因为它们无需包含在#ifdef语句中，以防止在零售版本的应用程序中调用它们。 这种灵活性是通过使用_DEBUG宏实现的；_RPT和_RPTF宏仅在定义了_DEBUG标志时可用。 未定义 _DEBUG 时，会在预处理过程中删除对这些宏的调用。

_RPTW 和 _RPTFW 宏是这些宏的宽字符版本。 它们类似于 wprintf 并将宽字符字符串用作参数。

_RPT宏调用_CrtDbgReport函数，生成包含用户消息的调试报告。 _RPTW 宏调用 _CrtDbgReportW 函数，生成具有宽字符的同一个报告。 除了用户消息以外，_RPTF 和 _RPTFW 宏还将创建包含调用报告宏所在的源文件和行号的调试报告。 通过使用由printf函数定义的相同规则将arg[n]参数替换为format字符串，以创建用户消息。

_CrtDbgReport 或 _CrtDbgReportW 会基于当前报告模式以及为 reportType 定义的文件，生成调试报告并确定其目标。 _CrtSetReportMode 和 _CrtSetReportFile 函数用于为每种报告类型定义目标。

如果调用_RPT宏，但不调用_CrtSetReportMode或_CrtSetReportFile，则显示以下消息：

报告类型 输出目标
_CRT_WARN 不显示警告文本。
_CRT_ERROR 弹出窗口。 如果指定了 _CrtSetReportMode(_CRT_ERROR, _CRTDBG_MODE_WNDW);，则相同。
_CRT_ASSERT 与 _CRT_ERROR 相同。

当目标为调试消息窗口且用户选择“重试”按钮时，_CrtDbgReport或_CrtDbgReportW返回 1。 如果启用了实时 (JIT) 调试，此返回值会导致这些宏启动调试器。 有关将这些宏用作调试错误处理机制的详细信息，请参阅用于报告的宏。

另外还有其他两个生成调试报告的宏： _ASSERT宏，但仅在其表达式参数计算结果为FALSE时生成报告。 _ASSERTE宏与_ASSERT非常类似，但会在生成的报告中包含失败的表达式。

要求

宏 必需的标头
_RPT 宏 <crtdbg.h>
_RPTF 宏 <crtdbg.h>
_RPTW 宏 <crtdbg.h>
_RPTFW 宏 <crtdbg.h>

有关兼容性的详细信息，请参阅 兼容性。

库

仅限 C 运行时库的调试版本。

虽然这些宏在包含crtdbg.h时可用，但要运行，应用程序必须链接其中一个调试库，因为这些宏会调用其他运行时函数。

示例

请参阅 _ASSERT 文章中的示例。

另请参阅

调试例程