次の方法で共有

_RPT、_RPTF、_RPTW、_RPTFW のマクロ

  • [アーティクル]

デバッグ レポートを生成することによって、アプリケーションの進行状況を追跡します (デバッグ バージョンのみ)。 注意nの引数の数を指定しますargs0、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パラメーター。 さらに、マクロ名の末尾の数字で示される追加引数を 4 つまで受け取ります。 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と**_RPTFマクロに似ています、printf、デバッグ処理中に、アプリケーションの進行状況を追跡するために使用できるため、機能します。 これらのマクロよりも柔軟性が、printfで囲む必要がないため#ifdefそれらを防止するステートメントには、アプリケーションのリテール ビルドでと呼ばれます。 使用してこのような柔軟性を実現、_DEBUGマクロ; _RPTと_RPTFマクロはのみ利用可能な場合、_DEBUG**フラグを定義します。 _DEBUG が未定義の場合、これらのマクロの呼び出しはプリプロセス時に削除されます。

_RPTWと**_RPTFW**ワイド文字のバージョンのこれらのマクロのマクロです。 これらは wprintf に似ていますが、引数としてワイド文字列を受け取ります。

_RPTマクロの呼び出しは、_CrtDbgReportユーザー メッセージとデバッグ レポートを生成する関数。 _RPTWマクロの呼び出しは、_CrtDbgReportWワイド文字で同じレポートを生成する関数。 _RPTFと**_RPTFW**マクロを作成、デバッグ レポートはレポート マクロ呼ばれた、またユーザー メッセージをソース ファイルと行番号をします。 ユーザー メッセージに置き換えることによって作成された、argn 引数にはformat、文字列で定義されている同じ規則を使用して、printf関数。

_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) デバッグが有効に、デバッガーの起動時にこれらのマクロの原因を返します。 これらのマクロをデバッグ時のエラー処理機構として使用する方法については、「レポート用マクロの使用」を参照してください。

デバッグ レポートを生成するマクロは、このほかに 2 つあります。 _ASSERT マクロは、式の引数が FALSE に評価された場合だけレポートを生成します。 _ASSERTE マクロは _ASSERT と同じですが、失敗した式がレポートで報告されます。

必要条件

マクロ

必須ヘッダー

_RPTマクロ

<crtdbg.h>

_RPTFマクロ

<crtdbg.h>

_RPTWマクロ

<crtdbg.h>

_RPTFWマクロ

<crtdbg.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

ライブラリ

C ランタイム ライブラリのデバッグ バージョンのみ。

これらのマクロは、Crtdbg.h をインクルードすると取得できます。ただし、これらのマクロは、他のランタイム関数を呼び出すため、アプリケーションをデバッグ ライブラリのアプリケーションにリンクしておく必要があります。

使用例

_ASSERT のトピックの例を参照してください。

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

参照

デバッグ ルーチン