CDesC8Array in System Libraries Application

class CDesC8Array : public CArrayFixBase, public MDesC8Array;

Description

An implementation base class for 8 bit descriptor arrays.

It provides some of the behaviour for 8 bit descriptor arrays. The class is abstract and cannot be instantiated.

Derivation

MDesC8Array - Interface class for 8 bit descriptor arrays. It should be inherited by classes w...

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

CArrayFixBase - Base class for arrays of fixed length objects.

CDesC8Array - An implementation base class for 8 bit descriptor arrays.

Members

Defined in CDesC8Array:

AppendL(const TDesC8 &)Appends a descriptor onto the end of any existing descriptor elements in the arr...
CDesC8Array(TBufRep,TInt)
Delete(TInt)
Delete(TInt,TInt)Deletes one or more logically contiguous descriptor elements from the array.
Find(const TDesC8 &,TInt &,TKeyCmpText)constFinds the position of a descriptor element within the array which matches the sp...
FindIsq(const TDesC8 &,TInt &,TKeyCmpText)constFinds the position of a descriptor element within the array which matches the sp...
InsertIsqAllowDuplicatesL(const TDesC8 &,TKeyCmpText)Inserts a descriptor into the array at a position which maintains the sequence o...
InsertIsqL(const TDesC8 &,TKeyCmpText)Inserts a descriptor into the array at a position which maintains the sequence o...
InsertL(TInt,const TDesC8 &)Inserts a descriptor into the array at the specified position.
MdcaCount()constReturns the number of descriptor elements in the array. The function implements ...
MdcaPoint(TInt)constIndexes into a descriptor array. The function implements the interface MDesC8Arr...
Reset()Deletes all descriptors from the array and frees the memory allocated to the arr...
Sort(TKeyCmpText)Sorts the descriptor elements into sequence.
operator[](TInt)const
~CDesC8Array()Frees all resources owned by the object, prior to its destruction. In particular...

Inherited from CArrayFixBase:

Compress()Compresses the array.
Count()constGets the number of elements held in the array.
Length()constGets the length of an element.
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...

protected: IMPORT_C CDesC8Array(TBufRep aRep, TInt aGranularity);

Description

Parameters

`TBufRep aRep`
`TInt aGranularity`

IMPORT_C ~CDesC8Array();

Description

Frees all resources owned by the object, prior to its destruction. In particular, it deletes all descriptors from the array and frees the memory allocated to the array buffer.

IMPORT_C void AppendL(const TDesC8 &aPtr);

Description

Appends a descriptor onto the end of any existing descriptor elements in the array.

Parameters

const TDesC8 &aPtr

A reference to the descriptor to be appended to the array.

Leave codes

KErrNoMemory

There is insufficient memory available. If the function leaves, the array is left in the state it was in before the call.

IMPORT_C void InsertL(TInt aPos, const TDesC8 &aPtr);

Description

Inserts a descriptor into the array at the specified position.

If the specified position is the same as the current number of descriptor elements in the array, this has the effect of appending the element.

Parameters

`TInt aPos`	The position within the array where the descriptor element is to be inserted. The position is relative to zero, i.e. zero implies the first descriptor element. This value must not be negative and must not be greater than the number of descriptor elements currently in the array, otherwise the function rasises an E32USER-CBase 21 panic.
`const TDesC8 &aPtr`	The descriptor to be inserted into the array.

Leave codes

KErrNoMemory

There is insufficient memory available. If the function leaves, the array is left in the state it was in before the call.

IMPORT_C TInt InsertIsqL(const TDesC8 &aPtr, TKeyCmpText aTextComparisonType=ECmpFolded);

Description

Inserts a descriptor into the array at a position which maintains the sequence of the descriptors.

The sequence is determined by comparing descriptors using one of the TDesC comparison functions. The enumeration aTextComparisonType governs how the descriptors are to be compared.

The array should already be in sequence, otherwise the position of the new descriptor element is unpredictable. Descriptor elements which are the same are not permitted.

Parameters

`const TDesC8 &aPtr`	A reference to the descriptor to be inserted into the array.
`TKeyCmpText aTextComparisonType`	An enumeration which determines the type of comparison to be made between descriptors for the purpose of choosing the insertion position. If no parameter is explicitly passed, ECmpFolded is used by default.

Return value

TInt

The position within the array of the inserted descriptor.

Leave codes

`KErrAlreadyExists`	A descriptor with the same data (i.e. the same length and the same content) already exists within the array.
`KErrNoMemory`	There is insufficient memory available. If the function leaves, the array is left in the state it was in before the call.

IMPORT_C TInt InsertIsqAllowDuplicatesL(const TDesC8 &aPtr, TKeyCmpText aTextComparisonType=ECmpFolded);

Description

Inserts a descriptor into the array at a position which maintains the sequence of the descriptors - allows duplicates.

The sequence is determined by comparing descriptors using one of the TDesC comparison functions. The enumeration aTextComparisonType governs how the descriptors are to be compared.

The array should already be in sequence, otherwise the position of the new descriptor element is unpredictable. Descriptor elements which are the same are permitted; if the descriptor aPtr is a duplicate of an existing descriptor within the array, then the new descriptor element is positioned after the existing descriptor element.

Parameters

`const TDesC8 &aPtr`	A reference to the descriptor to be inserted into the array.
`TKeyCmpText aTextComparisonType`	An enumeration which determines the type of comparison to be made between descriptors for the purpose of choosing the insertion position. If no parameter is explicitly passed, ECmpFolded is used by default.

Return value

TInt

The position within the array of the inserted descriptor.

Leave codes

KErrNoMemory

There is insufficient memory available. If the function leaves, the array is left in the state it was in before the call.

IMPORT_C void Sort(TKeyCmpText aTextComparisonType=ECmpFolded);

Description

Sorts the descriptor elements into sequence.

The sequence is determined by comparing descriptors using one of the member functions of the descriptor base class TDesC.

Parameters


                                 						TKeyCmpText aTextComparisonType

An enumeration which defines the type of comparison to be made between descriptors. By default the comparison type is ECmpFolded.

IMPORT_C TInt Find(const TDesC8 &aPtr, TInt &aPos, TKeyCmpText aTextComparisonType=ECmpFolded) const;

Description

Finds the position of a descriptor element within the array which matches the specified descriptor using a sequential search.

The array is searched sequentially for a matching descriptor element, starting with the first descriptor element in the array. Descriptors are compared using one of the TDesC comparison functions. The enumeration aTextComparisonType governs how the descriptors are to be compared.

Where an array has duplicate descriptor elements, the function only supplies the position of the first descriptor element.

Parameters

`const TDesC8 &aPtr`	A reference to a descriptor to be used for comparison.
`TInt &aPos`	If the descriptor element is found, this reference is set to the position of that descriptor element within the array. The position is relative to zero, (i.e. the first descriptor element in the array is at position 0). If the descriptor element is not found and the array is not empty, then the value of the reference is set to the number of descriptor elements in the array. If the descriptor element is not found and the array is empty, then the reference is set to zero.
`TKeyCmpText aTextComparisonType`	An enumeration which determines the type of comparison to be made between descriptors. If no parameter is explicitly passed, ECmpFolded is used by default.

Return value

TInt

Zero, if a matching descriptor element is found. Non-zero, if no matching descriptor element can be found.

IMPORT_C TInt FindIsq(const TDesC8 &aPtr, TInt &aPos, TKeyCmpText aTextComparisonType=ECmpFolded) const;

Description

Finds the position of a descriptor element within the array which matches the specified descriptor using a binary search technique. The array must be in sequence, otherwise the outcome is unpredictable.

Descriptors are compared using one of the TDesC comparison functions. The enumeration aTextComparisonType governs how the descriptors are to be compared.

Where an array has duplicate descriptor elements, the function cannot guarantee which matching descriptor element it will return; except that it will find one of them.

Parameters

`const TDesC8 &aPtr`	A reference to a descriptor to be used for comparison.
`TInt &aPos`	If the descriptor element is found, the reference is set to the position of that descriptor element within the array. The position is relative to zero, (i.e. the first descriptor element in the array is at position 0). If the descriptor element is not found and the array is not empty, then the reference is set to the position of the first descriptor element in the array whose content is greater than the content of aPtr. If the descriptor element is not found and the array is empty, then the reference is set to zero.
`TKeyCmpText aTextComparisonType`	An enumeration which determines the type of comparison to be made between descriptors. If no parameter is explicitly passed, ECmpFolded is used by default.

Return value

TInt

Zero, if a matching descriptor element is found. Non-zero, if no matching descriptor element can be found.

IMPORT_C void Delete(TInt aPos);

Description

Parameters


                                 						TInt aPos

IMPORT_C void Delete(TInt aIndex, TInt aCount);

Description

Deletes one or more logically contiguous descriptor elements from the array.

The deletion starts at the specified position.Deleting descriptor elements from the array frees the memory occupied by the associated heap descriptors and removes their pointers from the array buffer but does not cause the array buffer to be automatically compressed. Call the CArrayFixBase::Compress() function to return excess space in the array buffer to the heap.

Parameters

`TInt aIndex`
`TInt aCount`

IMPORT_C void Reset();

Description

Deletes all descriptors from the array and frees the memory allocated to the array buffer.

Description

Parameters


                                 						TInt aIndex

Return value


                                 						TPtrC8

IMPORT_C virtual TInt MdcaCount() const;

Description

Returns the number of descriptor elements in the array. The function implements the interface MDesC8Array::MdcaCount()const.

Return value

TInt

The number of descriptor elements.

IMPORT_C virtual TPtrC8 MdcaPoint(TInt aIndex) const;

Description

Indexes into a descriptor array. The function implements the interface MDesC8Array::MdcaPoint(TInt)const.

Parameters


                                 						TInt aIndex

The position of the descriptor element within the array. The position is relative to zero; i.e. zero implies the first descriptor element in the array. This value must be non-negative and less than the number of descriptors currently within the array otherwise the operator panics with EArrayIndexOutOfRange.

Return value

TPtrC8

A non-modifiable pointer descriptor representing the descriptor element located at position aIndex within the array.

Class CDesC8Array

Description

Derivation

Members

Construction and destruction

CDesC8Array(TBufRep,TInt)

Description

Parameters

~CDesC8Array()

Description

Member functions

AppendL(const TDesC8 &)

Description

Parameters

Leave codes

InsertL(TInt,const TDesC8 &)

Description

Parameters

Leave codes

InsertIsqL(const TDesC8 &,TKeyCmpText)

Description

Parameters

Return value

Leave codes

InsertIsqAllowDuplicatesL(const TDesC8 &,TKeyCmpText)

Description

Parameters

Return value

Leave codes

Sort(TKeyCmpText)

Description

Parameters

Find(const TDesC8 &,TInt &,TKeyCmpText)const

Description

Parameters

Return value

FindIsq(const TDesC8 &,TInt &,TKeyCmpText)const

Description

Parameters

Return value

Delete(TInt)

Description

Parameters

Delete(TInt,TInt)

Description

Parameters

Reset()

Description

See also:

operator[](TInt)const

Description

Parameters

Return value

MdcaCount()const

Description

Return value

MdcaPoint(TInt)const

Description

Parameters

Return value

Class `CDesC8Array`

`CDesC8Array(TBufRep,TInt)`

`~CDesC8Array()`

`AppendL(const TDesC8 &)`

`InsertL(TInt,const TDesC8 &)`

`InsertIsqL(const TDesC8 &,TKeyCmpText)`

`InsertIsqAllowDuplicatesL(const TDesC8 &,TKeyCmpText)`

`Sort(TKeyCmpText)`

`Find(const TDesC8 &,TInt &,TKeyCmpText)const`

`FindIsq(const TDesC8 &,TInt &,TKeyCmpText)const`

`Delete(TInt)`

`Delete(TInt,TInt)`

`Reset()`

`operator[](TInt)const`

`MdcaCount()const`

`MdcaPoint(TInt)const`