デバッグ ルーチン
更新 : 2007 年 11 月
C ランタイム ライブラリのデバッグ バージョンには数多くの診断サービスがあり、プログラムのデバッグをより簡単に行うことができます。次の作業を行うことができます。
デバッグ時にランタイム関数を直接実行します。
アサーション、エラー、および例外を解決します。
ヒープ割り当てをトレースし、メモリ リークを防止します。
ユーザーにデバッグ メッセージをレポートします。
デバッグ ルーチンを使用するには、_DEBUG フラグを定義する必要があります。これらのルーチンはすべて、アプリケーションのリリース版ビルドには影響しません。新しいデバッグ ルーチンの使い方の詳細については、「CRT のデバッグ技術」を参照してください。
デバッグ バージョンの C ランタイム ライブラリ ルーチン
ルーチン |
用途 |
同等の .NET Framework 関数 |
|---|---|---|
式を評価した結果が FALSE のときに、デバッグ レポートを生成します。 |
||
_ASSERT と似ていますが、失敗した式を生成したレポートに含めることができます。 |
||
デバッグ ヒープに割り当てられたメモリ ブロックの整合性を確認します。 |
||
ブレークポイントを設定します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
ユーザー メッセージ付きのデバッグ レポートを生成し、3 つの出力先に送信します。 |
System::Diagnostics::Debug::Write、System::Diagnostics::Debug::Writeline、System::Diagnostics::Debug::WriteIf、System::Diagnostics::Debug::WriteLineIf |
|
ヒープ内のすべての _CLIENT_BLOCK 型について、ユーザー定義関数を呼び出します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
重大なメモリ リークが発生すると、デバッグ ヒープのメモリ ブロックをすべてダンプします。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
指定されたメモリ ブロックがローカル ヒープ内にあり、有効なデバッグ ヒープ ブロック型識別子を持っていることを確認します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
指定されたポインタがローカル ヒープ内にあることを確認します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
指定されたメモリ範囲が読み出しと書き込み用に有効であることを確認します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
デバッグ ヒープの現在の状態を取得して、アプリケーション指定の _CrtMemState 構造体に格納します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
2 つのメモリ状態の違いを比較し、結果を返します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
プログラムの実行開始以降、または指定されたチェックポイント以降のヒープ内のオブジェクトに関する情報をダンプします。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
指定されたメモリ状態のデバッグ ヘッダー情報をユーザーが判読できる形式でダンプします。 |
||
指定されたデバッグ ヒープ ブロックへのポインタに関連付けられた、ブロック型またはブロック内部処理形式を返します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
クライアント定義の割り当て関数を C ランタイム デバッグのメモリ割り当てプロセスにフックして組み込みます。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
ブレークポイントを指定されたオブジェクト割り当て順序番号に設定する。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
_crtDbgFlag フラグの状態を取得または変更し、デバッグ ヒープ マネージャの割り当て動作を制御します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
デバッグ ダンプ関数を呼び出して _CLIENT_BLOCK 型のメモリ ブロックをダンプするたびに呼び出すアプリケーション定義関数を組み込みます。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
_CrtDbgReport が固有のレポートの種類の出力先として使用するファイルまたはストリームを識別します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
クライアント定義のレポート関数を C ランタイム デバッグのレポート プロセス中にフックして組み込みます。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
クライアント定義のレポート関数を C ランタイム デバッグのレポート プロセスにフックして組み込んだり組み込みを解除したりします。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
_CrtDbgReport が生成する固有のレポートの種類の一般的な出力先を指定します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
書式文字列と可変個の引数で _CrtDbgReport を呼び出してデバッグ レポートを生成することで、アプリケーションの進行状況を追跡します。ソース ファイルおよび行番号の情報は表示しません。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
_RPTn のマクロに似ていますが、レポートの要求元のソース ファイル名と行番号を表示します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
デバッグ ヘッダーと上書きバッファ用の領域と共に指定された数のメモリ ブロックをヒープに割り当てます。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
ヒープ内の指定されたメモリ ブロックを拡張または縮小して、サイズの変更を行います。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
ヒープ内のメモリ ブロックを解放します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
_malloc_dbg でメモリを割り当てて、指定された相対パス名に対応する絶対パス名、つまり完全パス名を作成します。 |
||
_malloc_dbg でメモリを割り当てて、現在の作業ディレクトリを取得します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
デバッグ ヘッダーと上書きバッファ用の領域と共にメモリ ブロックをヒープに割り当てます。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
ヒープ内のメモリ ブロックのサイズを計算します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
指定されたメモリ ブロックを移動またはサイズ変更して、ヒープに再度割り当てます。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
_malloc_dbg でメモリを割り当てて、文字列を複製します。 |
||
_malloc_dbg でメモリを割り当てて、一時ファイルの作成に使用できる名前を生成します。 |
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
デバッグ ルーチンを使用すると、ほとんどの C ランタイム ルーチンについても、デバッグ処理中にソース コードをステップ実行できます。ただし、Microsoft 社が権利を所有する技術が含まれている C ランタイム ルーチンのソース コードは公開されていません。ソース コードを公開していない C ランタイム ルーチンのほとんどは、例外処理ルーチンのカテゴリまたは浮動小数点サポートのカテゴリに分類されますが、その他のカテゴリに属するルーチンにでも同様にソース コードが公開されていない場合があります。これらのルーチンを次の表に示します。
ソース コード形式で使用できない C ランタイム ルーチン
printf、_printf_l、wprintf、_wprintf_l、printf_s、_printf_s_l、wprintf_s、_wprintf_s_l* |
||
scanf、_scanf_l、wscanf、_wscanf_l、scanf_s、_scanf_s_l、wscanf_s、_wscanf_s_l* |
||
|
* 大部分のソース コードが使用できます。ただし、内部的に呼び出している別のルーチンのソース コードは公開されていません。
C ランタイム関数および C++ 演算子には、デバッグ ビルドのアプリケーションで呼び出される場合に異なる動作を実行する演算子があります。アプリケーションのデバッグ ビルドを実行するには、_DEBUG フラグを定義しておくか、デバッグ バージョンの C ランタイム ライブラリとリンクします。通常、動作が異なるのは、デバッグ プロセスをサポートするルーチンに用意されている補足機能または補足情報に関する部分です。これらのルーチンを次の表に示します。
デバッグ ビルドのアプリケーションでは動作が異なるルーチン
C abort ルーチン |
C++ delete 演算子 |
C assert ルーチン |
C++ new 演算子 |
上記の表に記載されている C++ 演算子のデバッグ バージョンの使い方については、「C++ でのデバッグ ヒープ」を参照してください。