_RPT, _RPTF, _RPTW, макросы _RPTFW

Статья
02/20/2013

Отслеживает ход выполнения приложения, создавая отчет об отладке (отладочные версии).Обратите внимание, что 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
Аргументы подстановки, используемые by format.

Заметки

Все эти макросы получают reportTypeи formatпараметры.Кроме того, они также могут занять 4 дополнительных аргументов знаменованного добавить номеру к имени макроса.Например, _RPT0 и _RPTF0 может не иметь никаких дополнительных аргументов _RPT1 и _RPTF1 take arg1" _RPT2 и _RPTF2 take arg1 и arg2и т д

_RPT и _RPTF макросы аналогичны printf функция, поскольку их можно использовать для отслеживания хода выполнения приложения в процессе отладки.Однако эти макросы является более гибким, чем printf поскольку его не нужно заключать in #ifdef выписки для предотвращения их из розничном вызываться в построении приложения.Такая гибкость достигается с помощью _Отладка макрос; _RPT и _RPTF макросы доступны только при _DEBUG пометить определен.После _DEBUG обращения к данным не определяет макрос удалите во время предварительной обработки.

_RPTW и _RPTFW макросы версии расширенных символов этих макросов.Их как wprintf и выполните характерные черты в качестве аргументов.

_RPT макросы вызывают _CrtDbgReport функция для создания отчетов об отладке с сообщением пользователя._RPTW макросы вызывают _CrtDbgReportW функция позволяет создавать один и тот же отчет с расширенными символами._RPTF и _RPTFW макросы создают отчет об отладке с исходным файлом и номеру линии, где макрос отчета был вызван, в дополнение к сообщению пользователя.Сообщение пользователя создается путем подстановки arg[nаргументы в] format строка, используя те же правила, определенные printf функция.

_CrtDbgReport OR _CrtDbgReportW создает отчет об отладке и определяет его назначения на основании текущих условиях и в файле указанного для отчета reportType._CrtSetReportMode и _CrtSetReportFile функции, используемые для указания назначения для каждого типа отчета.

Если _RPT вызываемый макрос и ни одного _CrtSetReportMode ни _CrtSetReportFile вызывает сообщения отображение следующим образом.

Тип отчета	Назначение вывода
_CRT_WARN	Текст предупреждения не отображается.
_CRT_ERROR	Всплывающее окно.Такие же, как если бы _CrtSetReportMode(_CRT_ERROR, _CRTDBG_MODE_WNDW); определен.
_CRT_ASSERT	Эквивалентно _CRT_ERROR.

Если назначением является окно сообщения отладки и пользователь выберите Повторить кнопки _CrtDbgReport OR _CrtDbgReportW возвращает 1, вызывающие эти макросы запустить отладчик, при условии, что по требованию (JIT) отладка включена.Дополнительные сведения об использовании этих макросов, как механизм обработки ошибок отладки см. в разделах С помощью макросов для проверки и отчетности.

2 Остальных макросов существуют, который формируется отчет об отладке. _ASSERT макрос создает отчет, но только если аргумент выражения получается значение FALSE._ASSERTE в точности так же, как и _ASSERTсодержит выражение, но в созданном отчете.

Требования

Макрос	Обязательный заголовок
_RPT макросы	<crtdbg.h>
_RPTF макросы	<crtdbg.h>
_RPTW макросы	<crtdbg.h>
_RPTFW макросы	<crtdbg.h>

Дополнительные сведения о совместимости см. Совместимость во введении.

Библиотеки

Отладочные версии Библиотеки времени выполнения C только для чтения.

Хотя эти макросы и получаются путем включения Crtdbg.h приложение должно создать связь с одной из библиотек отладки, поскольку эти макросы вызывающие другие функции времени выполнения.

Пример

См. пример в _ASSERT разделе.

Эквивалент в .NET Framework

Неприменимо. Для c# используйте стандартная функция PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

См. также

Ссылки

Подпрограммы отладка

Поделиться через