CObArray::RemoveAll

  • 项目

voidRemoveAll();

Remarks

Removes all the pointers from this array but does not actually delete the CObject objects. If the array is already empty, the function still works.

The RemoveAll function frees all memory used for pointer storage.

The following table shows other member functions that are similar to CObArray::RemoveAll.

Class Member Function
CByteArray void RemoveAll( );
CDWordArray void RemoveAll( );
CPtrArray void RemoveAll( );
CStringArray void RemoveAll( );
CUIntArray void RemoveAll( );
CWordArray void RemoveAll( );

Example

See CObList::CObList for a listing of the CAge class used in all collection examples.

// example for CObArray::RemoveAll

CObArray array;
CAge* pa1;
CAge* pa2;

array.Add( pa1 = new CAge( 21 ) ); // Element 0
array.Add( pa2 = new CAge( 40 ) ); // Element 1
ASSERT( array.GetSize() == 2 );
array.RemoveAll(); // Pointers removed but objects not deleted.
ASSERT( array.GetSize() == 0 );
delete pa1;
delete pa2;  // Cleans up memory.

CObArray Overview |  Class Members |  Hierarchy Chart