Collapse all Symbian^3 Product Developer Library

CArrayPak< TAny > Class Template Reference

template <>

class CArrayPak< TAny > : public CArrayPakBase

A template specialisation base class for variable length, packed, arrays.

The array buffer organisation is defined at construction.

The class is useful for constructing an array of variable 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.

Inherits from

CArrayPak< TAny >
- CArrayPakBase
  - CBase

Public Member Functions
	CArrayPak(TBufRep, TInt)
void	AppendL(const TAny *, TInt)
const TAny *	At(TInt)
TAny *	At(TInt)
TAny *	ExtendL(TInt)

Inherited Functions
	CArrayPakBase::AtR(const CBase *,TInt)
	CArrayPakBase::BuildVarArrayL(CArrayVarFlat< TAny > *&)
	CArrayPakBase::CArrayPakBase(TBufRep,TInt)
	CArrayPakBase::Compress()
	CArrayPakBase::Count()const
	CArrayPakBase::CountR(const CBase *)
	CArrayPakBase::Delete(TInt)
	CArrayPakBase::Delete(TInt,TInt)
	CArrayPakBase::ExpandL(TInt,TInt)
	CArrayPakBase::Find(const TAny *,TKeyArrayPak &,TInt &)const
	CArrayPakBase::FindIsq(const TAny *,TKeyArrayPak &,TInt &)const
	CArrayPakBase::GetOffset(TInt)const
	CArrayPakBase::InsertIsqAllowDuplicatesL(const TAny *,TInt,TKeyArrayPak &)
	CArrayPakBase::InsertIsqL(const TAny *,TInt,TKeyArrayPak &)
	CArrayPakBase::InsertL(TInt,const TAny *,TInt)
	CArrayPakBase::Length(TInt)const
	CArrayPakBase::Reset()
	CArrayPakBase::SetKey(TKeyArrayPak &)const
	CArrayPakBase::SortL(TKeyArrayVar &)
	CArrayPakBase::~CArrayPakBase()
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Constructor & Destructor Documentation

CArrayPak(TBufRep, TInt)

CArrayPak	(	TBufRep	aRep,
		TInt	aGranularity
	)	[inline]

Constructs a variable array with the specified granularity and buffer organisation.

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

panic: E32USER-CBase 19, if aGranularity is not positive.

Parameters

TBufRep aRep	A pointer to a function used to expand the array buffer. The organisation of the array buffer is implied by the choice of this function. For a flat array buffer, pass (TBufRep)CBufFlat::NewL. For a segmented array buffer, pass (TBufRep)CBufSeg::NewL.
TInt aGranularity	The granularity of the array.

Member Functions Documentation

AppendL(const TAny *, TInt)

void	AppendL	(	const TAny *	aPtr,
			TInt	aLength
		)	[inline]

Appends the untyped element of the specified length onto the end of the array.

leave: KErrNoMemory The function attempted to expand the array buffer and there is insufficient memory available. In this case, the array is left in the state it was in before the call.

Parameters

const TAny * aPtr	A pointer to an untyped element to be appended.
TInt aLength	The length of the untyped element.

At(TInt)

const TAny *

(

TInt

anIndex

)

const [inline]

Gets a pointer to the untyped element located at the specified position within the array.

The compiler uses this variant of the function if the returned reference is used in an expression where that reference cannot be modified.

panic: E32USER-CBase 21, if anIndex is negative or greater than or equal to the number of objects currently within the array.

Parameters

TInt anIndex

The position of the element within the array, relative to zero; i.e. zero implies the first element.

At(TInt)

TAny *

(

TInt

anIndex

)

[inline]

Gets a pointer to the untyped element located at the specified position within the array.

The compiler uses this variant of the function if the returned reference is used in an expression where that reference can be modified.

panic: E32USER-CBase 21, if anIndex is negative or greater than or equal to the number of objects currently within the array.

Parameters

TInt anIndex

The position of the element within the array, relative to zero; i.e. zero implies the first element.

ExtendL(TInt)

TAny *

ExtendL

(

TInt

aLength

)

[inline]

Expands the array by one element of the specified length at the end of the array, and returns a pointer to this new location.

As elements are untyped, no construction is possible and the content of the new location remains undefined.

leave: KErrNoMemory The function attempted to expand the array buffer and there is insufficient memory available. In this case, the array is left in the state it was in before the call.

Parameters

TInt aLength

The length of the new element.