Collapse all Symbian^3 Application Developer Library

CLiwList Class Reference

class CLiwList : public CLiwContainer

Abstract interface for an ordered collection or sequence. Typically, the collection entries are of type TLiwVariant instances. CLiwList offers abstract methods to:

access elements based on an index
remove an element from the collection
append to an element to the collection
remove a key-value pair based on a key
get the total number of stored key-value pairs

A default concrete implementation is provided in the form of specialized class CLiwDefaultList

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! IMPORTANT NOTE !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Since container objects are reference counted, they cannot go with CleanupStack::PushL . The issue is solved by using CleanupClosePushL for pushing the container objects into the CleanupStack . Hence CLiwContainer::Close method is introduced common to all container objects.

This implies that the object of this concrete implementation class being created should be pushed into the CleanupStack using CLiwContainer::PushL .

ServiceHandler.lib

CLiwContainer CLiwContainer::Close CLiwContainer::PushL CLiwDefaultList

Inherits from

CLiwList
- CLiwContainer
  - CBase

Public Member Functions
void	AppendL (const TLiwVariant &)
TBool	AtL ( TInt , TLiwVariant &)
TInt	Count ()
void	Remove ( TInt )
IMPORT_C TBool	operator== (const CLiwList &)

Inherited Functions
	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()
	CLiwContainer::CLiwContainer()
	CLiwContainer::Close()
	CLiwContainer::DecRef()
	CLiwContainer::ExternalizeL(RWriteStream &)const
	CLiwContainer::IncRef()
	CLiwContainer::PushL()
	CLiwContainer::Size()const
	CLiwContainer::~CLiwContainer()

Member Functions Documentation

AppendL(const TLiwVariant &)

void

AppendL

(

const TLiwVariant &

aEntry

)

[pure virtual]

Appends an entry to the end of the collection. This is an abstract method.

CLiwDefaultList::AppendL

Parameters

const TLiwVariant & aEntry

an Element to be added to the end of the collection

AtL(TInt, TLiwVariant &)

TBool	AtL	(	TInt	aIndex,
			TLiwVariant &	aEntry
		)	const [pure virtual]

Gets an entry from the collection based on an integeral index.

!!!!!!!!!!!!!!!!!!!!!!!!!! IMPORTANT NOTE !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

This is a copy of the value present in the list at the particular index. To ensure proper cleanup TLiwVariant::PushL method should be called beforehand.

CLiwDefaultList::AtL TLiwVariant::PushL