CPosLmItemIterator Class Reference

class CPosLmItemIterator : public CBase

Landmark item iterator.

This is an abstract base class for objects which iterates a set of database items in a single database.

A database item is an item which is stored in a landmark database, i.e. a landmark or a landmark category.

Note that an iterator either iterates categories or landmarks. The items are never mixed.

This class does not export a constructor. The instance is created by the operation which generates the item set to be iterated. The iterator may implement a caching scheme, but that scheme depends on what is iterated.

eposlandmarks.lib S60 3.0

Inherits from

Constructor & Destructor Documentation

CPosLmItemIterator()

IMPORT_CCPosLmItemIterator()[protected]

CPosLmItemIterator(const CPosLmItemIterator &)

CPosLmItemIterator(const CPosLmItemIterator &)[private]

Parameters

const CPosLmItemIterator &

~CPosLmItemIterator()

IMPORT_C~CPosLmItemIterator()[virtual]

Destructor.

Member Functions Documentation

GetItemIdsL(RArray< TPosLmItemId > &, TInt, TInt)

voidGetItemIdsL(RArray< TPosLmItemId > &aIdArray,
TIntaStartIndex,
TIntaNumOfItems
)[pure virtual]

Fetches a sequence of database items from the iterated set.

The client supplies an ID array which will be filled by this operation. The array will be reset before any items are added.

The client specifies which database item sequence to fetch by supplying a start index (0 is the first item) and the number of items to fetch.

panic

"Landmarks Client"-EPosSpecifiedIntervalLiesOutsideIteratedSet specified interval lies [partially] outside the iterated set.

Parameters

RArray< TPosLmItemId > & aIdArrayOn return contains the requested items.
TInt aStartIndexThe index of the first item to fetch.
TInt aNumOfItemsThe number of items to fetch

NextL()

TPosLmItemId NextL()[pure virtual]

Returns the next database item ID in the iterated set.

The first call will return the first database item ID in the set.

The next database item ID, or KPosLmNullItemId if there are no more database items in the iterated set.

NumOfItemsL()

TUint NumOfItemsL()[pure virtual]

Returns the number of database items which are iterated.

Number of items in the iterated database item set.

Reset()

voidReset()[pure virtual]

Resets the database item iterator.

The next call to NextL will return the first database item ID in the iterated set.

operator=(const CPosLmItemIterator &)

CPosLmItemIterator &operator=(const CPosLmItemIterator &)[private]

Parameters

const CPosLmItemIterator &