Freigeben über


CMapStringToOb::RemoveAll

Entfernt alle Elemente aus dieser Zuordnung und zerstört die CString Schlüsselobjekte.

void RemoveAll( );

Hinweise

Die CObject-Objekte, die von jeder Schlüssel verweist, werden nicht zerstört. Die RemoveAll-Funktion kann Speicherverluste verursachen, wenn Sie nicht garantieren, dass die verwiesen wird CObject-Objekte zerstört werden.

Die Funktion ordnungsgemäß funktioniert, wenn die Zuordnung bereits leer ist.

In der folgenden Tabelle werden andere Memberfunktionen auf, die mit CMapStringToOb::RemoveAll ähneln.

Klasse

Memberfunktion

CMapPtrToPtr

ungültiges RemoveAll( );

CMapPtrToWord

ungültiges RemoveAll( );

CMapStringToPtr

ungültiges RemoveAll( );

CMapStringToString

ungültiges RemoveAll( );

CMapWordToOb

ungültiges RemoveAll( );

CMapWordToPtr

ungültiges RemoveAll( );

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse, die in allen Auflistungsbeispielen verwendet wird.

{
   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.         

Anforderungen

Header: afxcoll.h

Siehe auch

Referenz

CMapStringToOb-Klasse

Hierarchiediagramm

CMapStringToOb::RemoveKey