CArray::InsertAt

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 1

Aperçu de CArray |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;GetUpperBound, CArray::SetAt, CArray::RemoveAt

Index