CMapStringToString::PGetFirstAssoc

Returns the first entry of the map object.

const CPair* PGetFirstAssoc( ) const; 
CPair* PGetFirstAssoc( );

Return Value

A pointer to the first entry in the map; see CMapStringToString::CPair. If the map is empty, the value is NULL.

Remarks

Call this function to return a pointer the first element in the map object.

Example

CMapStringToString myMap;
CString myStr[4]={_T("One"), _T("Two"), _T("Three"), _T("Four")};
CMapStringToString::CPair* pCurVal;

myMap.InitHashTable(257);

// Add 4 elements to the map.
myMap.SetAt(myStr[0], _T("Odd"));
myMap.SetAt(myStr[1], _T("Even"));
myMap.SetAt(myStr[2], _T("Odd"));
myMap.SetAt(myStr[3], _T("Even"));

pCurVal = myMap.PGetFirstAssoc();
while (pCurVal != NULL)
{
   _tprintf_s(_T("Current key value at %s: %s\n"), 
      pCurVal->key, pCurVal->value);
   pCurVal= myMap.PGetNextAssoc(pCurVal);
}

Requirements

Header: afxcoll.h

See Also

Concepts

CMapStringToString Class

CMapStringToString Members

Hierarchy Chart

CMapStringToString::PGetNextAssoc

CMapStringToString::PLookup