CObArray::SetAt

Article
03/04/2013

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