Removes all the elements from this list and frees the associated CObList memory.
void RemoveAll( );
Remarks
No error is generated if the list is already empty.
When you remove elements from a CObList, you remove the object pointers from the list. It is your responsibility to delete the objects themselves.
The following table shows other member functions that are similar to CObList::RemoveAll.
Class |
Member Function |
|---|---|
void RemoveAll( ); |
|
void RemoveAll( ); |
Example
See CObList::CObList for a listing of the CAge class.
CObList list;
CAge* pa1;
CAge* pa2;
ASSERT(list.IsEmpty()); // Yes it is.
list.AddHead(pa1 = new CAge(21));
list.AddHead(pa2 = new CAge(40)); // List now contains (40, 21).
ASSERT(!list.IsEmpty()); // No it isn't.
list.RemoveAll(); // CAges aren't destroyed.
ASSERT(list.IsEmpty()); // Yes it is.
delete pa1; // Now delete the CAge objects.
delete pa2;
Requirements
Header: afxcoll.h