Class CArrayPtrFlat

class CArrayPtrFlat : public CArrayPtr< T >;

Description

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::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.

Derivation

• CArrayPtr< T > - No description.

• CArrayPtrFlat - Array of pointers to objects implemented using a flat dynamic buffer.

Members

Defined in CArrayPtrFlat:

• CArrayPtrFlat(TInt)Constructs a flat array of pointers with specified granularity.
• SetReserveL(TInt)Reserves space in the array buffer.

See also:

• CArrayPtr::ResetAndDestroy()Destroys all objects whose pointers form the elements of the array, before reset...
• RPointerArrayA simple and efficient array of pointers to objects.

inline CArrayPtrFlat(TInt aGranularity);

Description

Constructs a flat array of pointers with specified granularity.

Note that no memory is allocated to the array buffer by this constructor.

Parameters

TInt aGranularity The granularity of the array.

Panic codes

E32USER-CBase 18, if aGranularity is not positive.

inline void SetReserveL(TInt aCount);

Description

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()const returns the same value both before and after a call to this function.

Parameters

TInt 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.