CMapStringToOb::RemoveAll

すべての要素をこのマップから削除し、CString のキー オブジェクトを破棄します。

void RemoveAll( );

解説

各キーによって参照される CObject のオブジェクトは破棄されません。CObject の参照先オブジェクトが破棄されていることを確認する RemoveAll 関数ではメモリ リークが発生することがあります。

関数は、マップが既に空の場合は正しく動作します。

次の表は CMapStringToOb::RemoveAllに似ている他のメンバー関数を示します。

Class	メンバー関数
CMapPtrToPtr	void RemoveAll( );
CMapPtrToWord	void RemoveAll( );
CMapStringToPtr	void RemoveAll( );
CMapStringToString	void RemoveAll( );
CMapWordToOb	void RemoveAll( );
CMapWordToPtr	void RemoveAll( );

使用例

すべてのコレクションの例で使用されている CAge のクラスのリストについては、CObList::CObList を参照してください。

{
   CMapStringToOb map;

   CAge age1(13); // Two objects on the stack
   CAge age2(36);
   map.SetAt(_T("Bart"), &age1);
   map.SetAt(_T("Homer"), &age2);
   ASSERT(map.GetCount() == 2);
   map.RemoveAll(); // CObject pointers removed; objects not removed.
   ASSERT(map.GetCount() == 0);
   ASSERT(map.IsEmpty());
} // The two CAge objects are deleted when they go out of scope.         

必要条件

Header: afxcoll.h

参照

関連項目

CMapStringToOb クラス

階層図

CMapStringToOb::RemoveKey