Partager via


CAtlArray::InsertAt

Appelez cette méthode pour insérer un nouvel élément (ou de plusieurs copies d'un élément) dans l'objet table.

void InsertAt(
   size_t iElement,
   INARGTYPE element,
   size_t nCount = 1 
);

Paramètres

  • iElement
    L'index où le ou les éléments doivent être insérés.

  • element
    La valeur de l'élément ou des éléments à insérer.

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

Notes

Insère un ou plusieurs éléments dans le tableau, de départ à l'index iElement.Les éléments existants sont déplacés pour éviter d'être remplacés.

Dans les versions debug, un ATLASSERT sera déclenché si l'objet d' CAtlArray est incorrect, le nombre d'éléments à ajouter est zéro, ou mixte le nombre d'éléments est trop grand pour la matrice contienne.Dans les versions commerciales, passer des paramètres incorrects peut provoquer des résultats imprévisibles.

Exemple

// Declare an array of integers
CAtlArray<int> iBuffer;

// Add elements to the array
for (int b = 0; b < 10; b++)
{
   iBuffer.Add(0);
}

// Instert ten 1's into the array
// at position 5
iBuffer.InsertAt(5, 1, 10);   

Configuration requise

Header: atlcoll.h

Voir aussi

Référence

Classe de CAtlArray

CAtlArray::Add