CRBMultiMap::GetNextWithKey

Article
12/01/2015

Call this method to get the element associated with a given key and update the position value.

Syntax

      const CPair* GetNextWithKey(
   POSITION& pos,
   KINARGTYPE key 
) const throw( );
CPair* GetNextWithKey(
   POSITION& pos,
   KINARGTYPE key 
) throw( );

Parameters

pos
The position value, obtained with either a call to CRBMultiMap::FindFirstWithKey or CRBMultiMap::GetNextValueWithKey, or a previous call to GetNextWithKey.
key
Specifies the key that identifies the element to be found.

Return Value

Returns the next CRBTree::CPair Class element associated with the given key.

Remarks

The position value is updated to point to the next value associated with the key. If no more values exist, the position value is set to NULL.

See the documentation for the base class CRBTree for information on the other methods available.

Requirements

Header: atlcoll.h

Share via