This topic has not yet been rated - Rate this topic

CObList::RemoveAll

Visual Studio 2010

Removes all the elements from this list and frees the associated CObList memory.

Copy

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
CPtrList	void RemoveAll( );
CStringList	void RemoveAll( );

Example

See CObList::CObList for a listing of the CAge class.

C++

Copy


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

Reference

CObList Class

Hierarchy Chart

Other Resources

CObList Members

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ