class CArrayPtrFlat : public CArrayPtr |
Array of pointers to objects implemented using a flat dynamic buffer.
The elements of the array are pointers to instances of the template class T and are contained within a CBufFlat.
This type of array has the full behaviour of flat arrays but, in addition, the CArrayPtr<class T>::ResetAndDestroy() function offers a way of destroying all of the objects whose pointers form the elements of the array, before resetting the array.
Note that where possible, use the RPointerArray<class T> class as this is more efficient.
Public Member Functions | |
---|---|
CArrayPtrFlat(TInt) | |
void | SetReserveL(TInt) |
CArrayPtrFlat | ( | TInt | aGranularity | ) | [inline, explicit] |
Constructs a flat array of pointers with specified granularity.
Note that no memory is allocated to the array buffer by this constructor.
panic
E32USER-CBase 18, if aGranularity is not positive.
TInt aGranularity | The granularity of the array. |
void | SetReserveL | ( | TInt | aCount | ) | [inline] |
Reserves space in the array buffer.
If necessary, the array buffer is allocated or re-allocated so that it can accommodate the specified number of elements.
After a successful call to this function, elements can be added to the array and the process is guaranteed not to fail for lack of memory - provided the total number of elements does not exceed the specified number.
This function does not increase the number of elements in the array; i.e. the member function CArrayFixBase::Count() returns the same value both before and after a call to this function.
panic
E32USER-CBase 27, if aCount is less than the current number of elements in the array.
TInt aCount | The total number of elements for which space is to be reserved. |