CMapStringToOb::SetAt

Article
03/04/2013

La première méthode pour insérer un élément dans un mappage.

void SetAt(
   LPCTSTR key,
   CObject* newValue 
);

Paramètres

key
Spécifie la chaîne qui est la clé du nouvel élément.
newValue
Spécifie le pointeur d' CObject qui est la valeur du nouvel élément.

Notes

En premier lieu, la clé est trouvée.Si la clé est trouvée, la valeur correspondante est modifiée ; sinon un nouvel élément clé-valeur est créé.

Le tableau suivant indique les autres fonctions membres similaires à CMapStringToOb::SetAt.

Classe	Fonction membre
CMapPtrToPtr	void SetAt( void* key, void* newValue);
CMapPtrToWord	void SetAt( void* key, WORD newValue);
CMapStringToPtr	void SetAt( LPCTSTR key, void* newValue);
CMapStringToString	void SetAt( LPCTSTR key, LPCTSTR newValue);
CMapWordToOb	void SetAt( WORD key, CObject* newValue);
CMapWordToPtr	void SetAt( WORD key, void* newValue);

Exemple

Consultez CObList::CObList pour obtenir l'intégralité de la classe d' CAge utilisée dans les exemples de collection.

CMapStringToOb map;
CAge* pa;

map.SetAt(_T("Bart"), new CAge(13));
map.SetAt(_T("Lisa"), new CAge(11)); // Map contains 2 
                                        // elements.
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("before Lisa's birthday: ") << &map << _T("\n");
#endif
if (map.Lookup(_T("Lisa"), (CObject *&)pa))
{ // CAge 12 pointer replaces CAge 11 pointer.
   map.SetAt(_T("Lisa"), new CAge(12));
   delete pa;  // Must delete CAge 11 to avoid memory leak.
}
#ifdef _DEBUG
   afxDump << _T("after Lisa's birthday: ") << &map << _T("\n");
#endif

Les résultats de ce programme sont les suivantes :

before Lisa's birthday: A CMapStringToOb with 2 elements

[Lisa] = a CAge at $493C 11

[Bart] = a CAge at $4654 13

after Lisa's birthday: A CMapStringToOb with 2 elements

[Lisa] = a CAge at $49C0 12

[Bart] = a CAge at $4654 13