#include <e32base.h>
| class CArrayPtrFlat : public CArrayPtr |
| Public Member Functions | |
|---|---|
| CArrayPtrFlat(TInt) | |
| void | SetReserveL(TInt) |
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.
See also: CBufFlat CArrayPtr::ResetAndDestroy RPointerArray
| 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.
| Parameters | |
|---|---|
| aGranularity | The granularity of the array. |
| Panic Codes | |
|---|---|
| E32USER-CBase | 18, if aGranularity is not positive. |
| 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.
| Parameters | |
|---|---|
| aCount | The total number of elements for which space is to be reserved. |
| Panic Codes | |
|---|---|
| E32USER-CBase | 27, if aCount is less than the current number of elements in the array. |