void InsertAt ( int nIndex, CObject * "newelement", int nCount = 1 );
jeter ( CMemoryException );
voidInsertAt (nStartIndex,intCObArray *pNewArray);
jeter ( CMemoryException );
Paramètres
nIndex
Un index d'entiers qui peut être supérieur à la valeur retournée par GetUpperBound.
"newelement"
Le pointeur CObject pour figurer dans ce tableau. Un "newelement" de la valeur NULL est autorisée.
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 CObArray , 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.
Le tableau suivant montre les autres fonctions membres qui sont semblables aux CObArray::InsertAt.
Classe | Fonction membre |
CByteArray | void I&nsertAt (int nIndex, BYTE "newelement", int nCount=1) ; nbsp ;jeter ( CMemoryException );
void InsertAt (int nStartIndex, CByteArray * p&NewArray ) ; |
CDWordArray | void I&nsertAt (int nIndex, DWORD "newelement", int nCount=1) ; nbsp ;jeter ( CMemoryException );
void InsertAt (int nStartIndex, CDWordArray * p&NewArray ) ; |
CPtrArray | void I&nsertAt (int nIndex, void * "newelement", int nCount=1) ; nbsp ;jeter ( CMemoryException );
void InsertAt (int nStartIndex, CPtrArray * p&NewArray ) ; |
CStringArray | void I&nsertAt (int nIndex, LPCTSTR "newelement", int nCount=1) ; nbsp ;jeter ( CMemoryException );
void InsertAt (int nStartIndex, CStringArray * p&NewArray ) ; |
CUIntArray | void InsertAt (int nIndex, UI&NT "newelement", int nCount=1) ; nbsp ;jeter ( CMemoryException );
void InsertAt (int nStartIndex, CUIntArray * p&NewArray ) ; |
CWordArray | void I&nsertAt (int nIndex, le mot "newelement", int nCount=1) ; nbsp ;jeter ( CMemoryException );
void InsertAt (int nStartIndex, CWordArray * p&NewArray ) ; |
Exemple
Voir CObList::CObList pour obtenir la liste de la CAge
classe utilisée dans tous les exemples de la collection.
/ / exemple de CObArray::InsertAt
nbsp ; CObArray tableau ;
tableau.Ajouter (nouvelle CAge (21)) ; / / Élément 0
tableau.Ajouter (nouvelle CAge (40)) ; / / Élément 1 (deviendra 2).
tableau.InsertAt (1, nouvelle CAge (30)) ; / / Nouvel élément 1
# ifdef _DEBUG
afxDump.SetDepth (1) ;
afxDump << « InsertAt exemple: "<< & tableau << « \n » ;
# endif
Les résultats de ce programme sont les suivants:
I&nsertAt exemple : un CObArray avec 3 éléments
nbsp ; [0] = une CAge à 45 $C 8 21
[1] = une CAge à $4646 30
[2] = une CAge à 4606 $ 40
Aperçu de CObArray |  ; Membres de la classe | Graphique de la hiérarchie
Voir aussi  ;CObArray::SetAt, CObArray::RemoveAt