Partager via


CObArray::SetAt

Définit l'élément de tableau à l'index spécifié.

void SetAt( 
   INT_PTR nIndex, 
   CObject* newElement  
);

Paramètres

  • nIndex
    Un index d'entiers qui est supérieur ou égal à 0 et inférieure ou égale à la valeur retournée par GetUpperBound.

  • newElement
    Le pointeur d'objet à insérer dans ce tableau. Il permet une valeur de NULL .

Notes

SetAt ne fera pas développer le tableau. Utilisez SetAtGrow si vous souhaitez tableau pour développer automatiquement.

Vous devez vérifier que la valeur d'index représente une position valide dans le tableau. Si elle est hors limites, la version debug des assertions de bibliothèque.

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

Classe

Fonction membre

CByteArray

void SetAt( INT_PTRnIndex, BYTE newElement);

CDWordArray

void SetAt( INT_PTRnIndex, DWORD newElement);

CPtrArray

void SetAt( INT_PTRnIndex, void* newElement);

CStringArray

void SetAt( INT_PTRnIndex, LPCTSTR newElement);

CUIntArray

void SetAt( INT_PTRnIndex, UINT newElement);

CWordArray

void SetAt( INT_PTRnIndex, WORD newElement);

Exemple

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

CObArray arr;
CObject* pa;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1 
if ((pa = arr.GetAt(0)) != NULL)
{
   arr.SetAt(0, new CAge(30));  // Replace element 0. 
   delete pa; // Delete the original element at 0.
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("SetAt example: ") << &arr << _T("\n");
#endif      

Les résultats de ce programme sont les suivantes :

SetAt example: A CObArray with 2 elements

[0] = a CAge at $47E0 30

[1] = a CAge at $47A0 40

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

CObArray, classe

Graphique de la hiérarchie

CObArray::GetAt

CObArray::SetAtGrow

CObArray::ElementAt

CObArray::operator []