Share via


CMapStringToOb::RemoveAll

從這個對應移除所有項目並終結 CString 索引鍵物件。

void RemoveAll( );

備註

不會終結每個索引鍵所參考的 CObject 物件。 RemoveAll 函式會造成記憶體遺漏 (Memory Leak),如果您不確定終結參考的 CObject 物件。

如果對應已經是 null,則函式正確運作。

下表顯示類似 CMapStringToOb::RemoveAll的其他成員函式。

類別

成員函式

CMapPtrToPtr

空 RemoveAll ();

CMapPtrToWord

空 RemoveAll ();

CMapStringToPtr

空 RemoveAll ();

CMapStringToString

空 RemoveAll ();

CMapWordToOb

空 RemoveAll ();

CMapWordToPtr

空 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