CMapStringToOb::RemoveAll

[アーティクル]
08/09/2011

マップ内のすべての要素を削除し、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.