Partager via


CAtlArray::RemoveAt

Appelez cette méthode pour supprimer un ou plusieurs éléments du tableau.

void RemoveAt( 
   size_t iElement, 
   size_t nCount = 1  
);

Paramètres

  • iElement
    Index du premier élément à supprimer.

  • nCount
    Nombre d'éléments à supprimer.

Notes

Supprime un ou plusieurs éléments du tableau. Tous les éléments restants sont déplacés vers le bas. La limite supérieure est décrémentée, mais la mémoire n'est pas libérée jusqu'à ce qu'un appel à CAtlArray::FreeExtra soit effectué.

Dans les versions debug, un ATLASSERT sera déclenché si l'objet d' CAtlArray est pas valide, ou si le total combiné d' iElement et d' nCount dépasse le nombre total d'éléments du tableau. Dans les versions commerciales, les paramètres incorrects peuvent provoquer des résultats imprévisibles.

Exemple

// Declare an array of chars
CAtlArray<char> cMyArray;

// Add ten elements to the array 
for (int a = 0; a < 10; a++)
{
   cMyArray.Add('*');
}

// Remove five elements starting with 
// the element at position 1
cMyArray.RemoveAt(1, 5);

// Free memory
cMyArray.FreeExtra();

// Confirm size of array
ATLASSERT(cMyArray.GetCount() == 5);   

Configuration requise

Header: atlcoll.h

Voir aussi

Référence

CAtlArray, classe

CAtlArray::RemoveAll