CMapStringToOb::GetStartPosition

Starts a map iteration by returning a POSITION value that can be passed to a GetNextAssoc call.

POSITION GetStartPosition( ) const;

Return Value

A POSITION value that indicates a starting position for iterating the map; or NULL if the map is empty.

Remarks

The iteration sequence is not predictable; therefore, the "first element in the map" has no special significance.

The following table shows other member functions that are similar to CMapStringToOb::GetStartPosition.

Class	Member Function
CMapPtrToPtr	POSITION GetStartPosition( ) const;
CMapPtrToWord	POSITION GetStartPosition( ) const;
CMapStringToPtr	POSITION GetStartPosition( ) const;
CMapStringToString	POSITION GetStartPosition( ) const;
CMapWordToOb	POSITION GetStartPosition( ) const;
CMapWordToPtr	POSITION GetStartPosition( ) const;

Example

See the example for CMapStringToOb::GetNextAssoc.

Requirements

Header: afxcoll.h

See Also

Concepts

CMapStringToOb Class

CMapStringToOb Members

Hierarchy Chart