CMapStringToOb::RemoveAll

Artikel
02/26/2013

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

Hierarchien-Diagramm

CMapStringToOb::RemoveKey

Freigeben über