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

Reference

CMapStringToOb Class

Hierarchy Chart