CObject::Dump
CDumpContext のオブジェクトへのオブジェクトの内容をダンプします。
virtual void Dump(
CDumpContext& dc
) const;
パラメーター
- dc
通常、afxDumpの診断ダンプ コンテキスト ダンプします。
解説
独自のクラスを記述する場合は、クラスで独自および他のユーザーに診断サービスを提供するために Dump 関数をオーバーライドする必要があります。オーバーライドされた Dump は、通常、データ メンバーを印刷する前に、基本クラスの Dump 関数を派生クラスによって呼び出されます。CObject::Dump は、クラスが IMPLEMENT_DYNAMIC または IMPLEMENT_SERIAL マクロを使用してクラス名を出力します。
[!メモ]
Dump の関数では、出力の末尾に改行文字を印刷する必要はありません。
Dump の呼び出しは、Microsoft Foundation Class ライブラリのデバッグ バージョンでのみ意味を持ちます。条件付きコンパイルの #ifdef _DEBUG/#endif の呼び出しステートメントを使用して、関数の宣言と関数の実装をかっこに入れる必要があります。
Dump が const 関数であるため、ダンプ時にオブジェクトの状態を変更するには、では使用できません。
CDumpContext の挿入] (<<) 演算子 は CObject のポインターが挿入されると Dump を呼び出します。
Dump は、オブジェクトの非循環」「にスローされるだけを使用できます。オブジェクトのリストをダンプできます。たとえば、オブジェクトの 1 つがリスト自体の場合、最終的にスタック オーバーフローを防止できます。
使用例
CObject のすべての例で使用されている CAge のクラスのリストについては、CObList::CObList を参照してください。
void CAge::Dump(CDumpContext &dc) const
{
CObject::Dump(dc);
dc << _T("Age = ") << m_years;
}
必要条件
ヘッダー : afx.h