CObArray::RemoveAt

Article
06/10/2015

Supprime un ou plusieurs éléments à partir d'un index spécifié dans un tableau.

void RemoveAt( 
   INT_PTR nIndex, 
   INT_PTR nCount = 1  
);

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.
nCount
Nombre d'éléments à supprimer.

Notes

Dans le processus, il déplace vers le bas de tous les éléments au-dessus de les éléments supprimés. Il décrémente la limite supérieure du tableau mais ce n'est pas mémoire.

Si vous essayez de supprimer des éléments qui sont contenus dans le tableau au-dessus de le point de suppression, la version debug des assertions de bibliothèque.

La fonction d' RemoveAt supprime le pointeur d' CObject du tableau, mais ne supprime pas l'objet lui-même.

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

Classe	Fonction membre
CByteArray	void RemoveAt( INT_PTR nIndex, INT_PTR nCount = 1 );
CDWordArray	void RemoveAt( INT_PTR nIndex, INT_PTR nCount = 1 );
CPtrArray	void RemoveAt( INT_PTR nIndex, INT_PTR nCount = 1 );
CStringArray	void RemoveAt( INT_PTR nIndex, INT_PTR nCount = 1 );
CUIntArray	void RemoveAt( INT_PTR nIndex, INT_PTR nCount = 1 );
CWordArray	nCount = 1 );devoid RemoveAt( INT_PTRnIndex, INT_PTR

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.RemoveAt(0);  // Element 1 moves to 0. 
    delete pa; // Delete the original element at 0.
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("RemoveAt example: ") << &arr << _T("\n");
#endif

Les résultats de ce programme sont les suivantes :

RemoveAt example: A CObArray with 1 elements

[0] = a CAge at $4606 40