CAtlMap::GetNext

 

Call this method to obtain a pointer to the next element pair stored in the CAtlMap object.

Syntax

      CPair* GetNext(
   POSITION& pos 
) throw( );
const CPair* GetNext(
   POSITION& pos 
) const throw( );

Parameters

• pos
  The position counter, returned by a previous call to CAtlMap::GetNextAssoc or CAtlMap::GetStartPosition.

Return Value

Returns a pointer to the next pair of key/value elements stored in the map. The pos position counter is updated after each call. If the retrieved element is the last in the map, pos is set to NULL.

Requirements

Header: atlcoll.h

See Also

CAtlMap Class
CAtlMap::GetNextAssoc
CAtlMap::GetNextKey
CAtlMap::GetNextValue
CAtlMap::CPair Class