This documentation is archived and is not being maintained.

CRBMultiMap::FindFirstWithKey 

Call this method to find the position of the first element with a given key.


POSITION FindFirstWithKey(
   KINARGTYPE key 
) const throw( );

Parameters

key

Specifies the key that identifies the element to be found.

Returns the POSITION of the first key/value element if the key is found, NULL otherwise.

A key in the CRBMultiMap can have one or more associated values. This method will provide the position value of the first value (which may, in fact, be the only value) associated with that particular key. The position value returned can then be used with CRBMultiMap::GetNextValueWithKey or CRBMultiMap::GetNextWithKey to obtain the value and update the position.

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

See the example for CRBMultiMap::CRBMultiMap.

Show: