Class CArrayFixSeg< TAny >

class CArrayFixSeg< TAny > : public CArrayFix< TAny >;

Description

An array of fixed length untyped objects using a segmented dynamic buffer.

The array elements are contained within a CBufSeg.

The class is useful for constructing an array of fixed length buffers, where the length is decided at run time.

This class is also useful as a data member of a base class in a thin template class/base class pair where the type of the array element is not known until the owning thin template class is instantiated.

Derivation

• CBase - Base class for all classes to be instantiated on the heap.

• CArrayFixBase - Base class for arrays of fixed length objects.

• CArrayFix< TAny > - A template specialisation base class for arrays of fixed length untyped objects.

• CArrayFixSeg< TAny > - An array of fixed length untyped objects using a segmented dynamic buffer.

Members

Defined in CArrayFixSeg< TAny >:

• CArrayFixSeg(TInt,TInt)Constructs a segmented array of fixed length objects with the specified granular...

Inherited from CArrayFix< TAny >:

• AppendL(const TAny *)Appends the specified untyped element onto the end of the array.
• AppendL(const TAny *,TInt)Appends one or more untyped elements onto the end of the array.
• At(TInt)Gets a pointer to the untyped element located at the specified position within t...
• At(TInt)constGets a pointer to the untyped element located at the specified position within t...
• Back(TInt)Gets a pointer to the beginning of a contiguous region.
• Back(TInt)constGets a pointer to the beginning of a contiguous region.
• End(TInt)Gets a pointer to the first byte following the end of the contiguous region cont...
• End(TInt)constGets a pointer to the first byte following the end of the contiguous region cont...
• ExtendL()Expands the array by the length of one element at the end of the array and retur...

Inherited from CArrayFixBase:

• Compress()Compresses the array.
• Count()constGets the number of elements held in the array.
• Delete(TInt)Deletes a single element from the array at a specified position.
• Delete(TInt,TInt)Deletes one or more contiguous elements from the array, starting at a specific p...
• Length()constGets the length of an element.
• Reset()Deletes all elements from the array and frees the memory allocated to the array ...
• Sort(TKeyArrayFix &)Sorts the elements of the array into key sequence.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

inline CArrayFixSeg(TInt aRecordLength, TInt aGranularity);

Description

Constructs a segmented array of fixed length objects with the specified granularity to contain elements of the specified length.

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

Parameters

TInt aRecordLength The length of the elements of this array. TInt aGranularity The granularity of the array.

Return value

Panic codes

E32USER-CBase 17, if aRecordLength is not positive. E32USER-CBase 18, if aGranularity is not positive.