Partager via


CMapStringToOb::SetAt

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

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

CMapStringToOb, classe

Graphique de la hiérarchie

CMapStringToOb::Lookup

CMapStringToOb::operator []