void InsertAt ( int nIndex, ARG_TYPE "newelement", int nCount = 1 );
jeter ( CMemoryException );
voidInsertAt (nStartIndex,intCArray *pNewArray);
jeter ( CMemoryException );
Paramètres
nIndex
Un index d'entiers qui peut être supérieur à la valeur retournée par GetUpperBound.
ARG_TYPE
Paramètre de modèle spécifiant le type d'éléments dans ce tableau.
"newelement"
L'élément doit être placée dans ce tableau.
nCount
Le nombre de fois que cet élément doit être inséré (1 par défaut).
nStartIndex
Un index d'entiers qui peut être supérieur à la valeur retournée par GetUpperBound.
pNewArray
Un autre tableau qui contient les éléments à ajouter à ce tableau.
Remarques
La première version de InsertAt insère un élément (ou plusieurs copies d'un élément) à un index spécifié dans un tableau. Dans le processus, il se déplace (par incrémentation de l'index) l'élément existant à cet indice et il se déplace jusqu'à tous les éléments dessus.
La deuxième version insère tous les éléments d'une autre collection de CArray , commençant à la position de nStartIndex.
La fonction SetAt , en revanche, remplace un élément du tableau spécifié et ne change pas tous les éléments.
Exemple
/ / exemple de CArray::InsertAt
CArraylt ;CPoint, CPoint > ptArray ;
ptArray.Add(CPoint(10,20)) ; / / Élément 0
ptArray.Add(CPoint(30,40)) ; / / Élément 1 (deviendra élément 2)
ptArray.InsertAt (1, CPoint(50,60)) ; / / Nouvel élément 1Aperçu de CArray | ; Membres de la classe | Graphique de la hiérarchie
Voir aussi ;GetUpperBound, CArray::SetAt, CArray::RemoveAt