_RPT, _RPTF, _RPTW, _RPTFW makra

Článek
03/04/2013

Generování sestavy ladění (pouze ladicí verze) sleduje průběh dané aplikace.Všimněte si, že n určuje počet argumentů v args a může být 0, 1, 2, 3, 4 nebo 5.

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

Parametry

reportType
Report type: _CRT_WARN, _CRT_ERROR, or _CRT_ASSERT.
format
Formát ovládacího řetězec použitý k vytvoření zprávy pro uživatele.
args
Nahrazení argumenty použité příkazem format.

Poznámky

Tato makra trvat reportTypea formatparametry.Kromě toho se může trvat až čtyři další argumenty, které jsou označeny číslem připojeným název makra.For example, _RPT0 and _RPTF0 take no additional arguments, _RPT1 and _RPTF1 take arg1, _RPT2 and _RPTF2 take arg1 and arg2, and so on.

_RPT a _RPTF makra jsou podobné printf fungovat, protože bylo možné sledovat průběh aplikace během ladění.Tato makra jsou však flexibilnější než printf protože není třeba uzavřít do #ifdef nazývá výkazy a zabránit jim v prodejní sestavení aplikace.Tato pružnost je dosaženo použitím _DEBUG makra. _RPT a _RPTF makra jsou k dispozici pouze pokud _DEBUG je definována příznak.Při _DEBUG je volání makra, nejsou definovány, budou odebrány při úpravě před zpracováním.

_RPTW a _RPTFW makra jsou verze znaku wide tato makra.Jsou jako wprintf a celého řetězce jako argumenty.

_RPT Volání makra _CrtDbgReport funkci generování sestavy uživatele zprávy ladění._RPTW Volání makra _CrtDbgReportW funkce pro vygenerování sestavy stejná s širokou znaky._RPTF a _RPTFW makra vytvořit sestavu ladění souboru a řádek číslo zdroje kde byla volána makra sestavy, kromě zprávy uživatele.Nahrazování vytvoří zprávu argn argumenty doformat řetězec pomocí stejných pravidel definované printf funkce.

_CrtDbgReportnebo _CrtDbgReportW generuje sestavu ladění a určuje jeho cíle na základě aktuální sestavy režimy a soubor definice pro reportType._CrtSetReportMode a _CrtSetReportFile funkce se používají k definování cílů pro každý typ sestavy.

Pokud _RPT makro se nazývá a ani _CrtSetReportMode ani _CrtSetReportFile byla volána, zprávy jsou zobrazeny takto.

Typ sestavy	Cíl výstupu
_CRT_WARN	Text upozornění nejsou zobrazeny.
_CRT_ERROR	Rozbalovací okno.Stejné jako _CrtSetReportMode(_CRT_ERROR, _CRTDBG_MODE_WNDW); bylo určeno.
_CRT_ASSERT	Same as _CRT_ERROR.

Pokud cíl je okno zprávy ladění a uživatel zvolí Opakovat tlačítko, _CrtDbgReport nebo _CrtDbgReportW vrátí hodnotu 1, způsobuje tato makra spustit ladicí program, za předpokladu, že je povoleno ladění just-in-time (JIT).Další informace o použití těchto maker jako ladění chyb zpracování mechanismus viz Pomocí makra pro ověření a hlášení.

Existují dvě makra, které generovat sestavu ladění._ASSERT makro vygeneruje zprávu, ale pouze při jeho argument výraz vyhodnocen jako NEPRAVDA._ASSERTE je přesně obdobného _ASSERT, ale obsahuje generovanou sestavu výrazu se nezdařilo.

Požadavky

Makro	Požadované záhlaví
_RPTmakra	<crtdbg.h>
_RPTFmakra	<crtdbg.h>
_RPTWmakra	<crtdbg.h>
_RPTFWmakra	<crtdbg.h>

Další informace o kompatibilitě v tématu Compatibility v úvodu.

Knihovny

Ladění verze C Runtime knihovny pouze.

Ačkoli tato makra jsou a jsou získány, včetně Crtdbg.h, aplikace musí propojit s jedním ladění knihoven protože tato makra volání jiných funkcí runtime.

Příklad

Viz příklad v _ASSERT téma.

Ekvivalent v rozhraní .NET Framework

Nelze použít Použijte volání funkce standardní C, PInvoke. Další informace naleznete v tématu Příklady vyvolat platformu.

Viz také

Referenční dokumentace

Ladění rutin

Sdílet prostřednictvím