Partager via


CArray::InsertAt

La première version d' InsertAt insère un élément (ou plusieurs copies d'un élément) à un index spécifié dans un tableau.

void InsertAt(
   INT_PTR nIndex,
   ARG_TYPE newElement,
   INT_PTR nCount = 1 
);
void InsertAt(
   INT_PTR nStartIndex,
   CArray* pNewArray 
);

Paramètres

  • nIndex
    Un index d'entiers qui peut être supérieur à la valeur retourné par GetUpperBound.

  • ARG_TYPE
    Paramètre de modèle spécifiant le type d'éléments dans ce tableau.

  • newElement
    L'élément à définir dans ce tableau.

  • nCount
    Nombre de fois où cet élément doit être inséré (les valeurs par défaut à 1).

  • nStartIndex
    Un index d'entiers qui peut être supérieur à la valeur retourné par GetUpperBound.

  • pNewArray
    Un autre tableau qui contient les éléments à ajouter à ce tableau.

Notes

Dans le processus, il déplace vers le haut (en incrémentant l'index) de l'élément existant à cet index, et il déplace vers le haut de tous les éléments au-dessus.

La deuxième version insère tous les éléments d'une autre collection d' CArray , à partir de la position d' nStartIndex .

La fonction d' SetAt , en revanche, remplace un élément de tableau spécifié et ne déplace pas d'éléments.

Exemple

// example for CArray::InsertAt

CArray<CPoint,CPoint> ptArray;

ptArray.Add(CPoint(10,20));   // Element 0
ptArray.Add(CPoint(30,40));   // Element 1 (will become element 2)
ptArray.InsertAt(1, CPoint(50,60));   // New element 1      

Configuration requise

Header: afxtempl.h

Voir aussi

Référence

Classe de CArray

Graphique de la hiérarchie

CArray::GetUpperBound

CArray::SetAt

CArray::RemoveAt