Partager via


CObArray::RemoveAt

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

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

Classe de CObArray

Graphique de la hiérarchie

CObArray::SetAt

CObArray::SetAtGrow

CObArray::InsertAt