CObArray::InsertAt

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 ) ;
nbsp ;jeter ( CMemoryException );

CDWordArray void I&nsertAt (int nIndex, DWORD "newelement", int nCount=1) ;
nbsp ;jeter ( CMemoryException );

void InsertAt (int nStartIndex, CDWordArray * p&NewArray ) ;
nbsp ;jeter ( CMemoryException );

CPtrArray void I&nsertAt (int nIndex, void * "newelement", int nCount=1) ;
nbsp ;jeter ( CMemoryException );

void InsertAt (int nStartIndex, CPtrArray * p&NewArray ) ;
nbsp ;jeter ( CMemoryException );

CStringArray void I&nsertAt (int nIndex, LPCTSTR "newelement", int nCount=1) ;
nbsp ;jeter ( CMemoryException );

void InsertAt (int nStartIndex, CStringArray * p&NewArray ) ;
nbsp ;jeter ( CMemoryException );

CUIntArray void InsertAt (int nIndex, UI&NT "newelement", int nCount=1) ;
nbsp ;jeter ( CMemoryException );

void InsertAt (int nStartIndex, CUIntArray * p&NewArray ) ;
nbsp ;jeter ( CMemoryException );

CWordArray void I&nsertAt (int nIndex, le mot "newelement", int nCount=1) ;
nbsp ;jeter ( CMemoryException );

void InsertAt (int nStartIndex, CWordArray * p&NewArray ) ;
nbsp ;jeter ( CMemoryException );


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

Index