CMapStringToString::PGetFirstAssoc

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

マップオブジェクトの最初のエントリを返します。

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

戻り値

マップ内の最初のエントリへのポインタを返します。「CMapStringToString::CPair」を参照してください。マップが空の場合は NULL を返します。

解説

マップオブジェクトの最初の要素へのポインタを返します。

使用例

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);
}