CObArray::InsertAt

Article
06/10/2015

Insère un élément (ou les éléments dans un autre tableau) à un index spécifié.

void InsertAt( 
   INT_PTR nIndex, 
   CObject* newElement, 
   INT_PTR nCount = 1  
); 
void InsertAt( 
   INT_PTR nStartIndex, 
   CObArray* pNewArray  
);

Paramètres

nIndex
Un index d'entiers qui peut être supérieur à la valeur retourné par GetUpperBound.
newElement
Le pointeur d' CObject à définir dans ce tableau. Il permet newElement de valeur NULL .
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

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. 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' CObArray , à 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.

Le tableau suivant indique les autres fonctions membres similaires à CObArray::InsertAt.

Classe	Fonction membre
CByteArray	void InsertAt( INT_PTR nIndex, BYTE newElement, int nCount=1 ); *jet (CMemoryException) ; void InsertAt( INT_PTR** nStartIndex, CByteArray* pNewArray); *jet (CMemoryException) ;**
CDWordArray	void InsertAt( INT_PTR nIndex, DWORD newElement, int nCount=1 ); *jet (CMemoryException) ; void InsertAt( INT_PTR** nStartIndex, CDWordArray* pNewArray); *jet (CMemoryException) ;**
CPtrArray	void InsertAt( INT_PTR nIndex, void* newElement, int nCount=1 ); *jet (CMemoryException) ; void InsertAt( INT_PTR** nStartIndex, CPtrArray* pNewArray); *jet (CMemoryException) ;**
CStringArray	void InsertAt( INT_PTR nIndex, LPCTSTR newElement, int nCount=1 ); *jet (CMemoryException) ; void InsertAt( INT_PTR** nStartIndex, CStringArray* pNewArray); *jet (CMemoryException) ;**
CUIntArray	void InsertAt( INT_PTR nIndex, UINT newElement, int nCount=1 ); *jet (CMemoryException) ; void InsertAt( INT_PTR** nStartIndex, CUIntArray* pNewArray); *jet (CMemoryException) ;**
CWordArray	void InsertAt( INT_PTR nIndex, WORD newElement, int nCount=1 ); *jet (CMemoryException) ; void InsertAt( INT_PTR** nStartIndex, CWordArray* pNewArray); *jet (CMemoryException) ;**

Exemple

Consultez CObList::CObList pour obtenir l'intégralité de la classe d' CAge utilisée dans les exemples de collection.

CObArray arr;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1 (will become 2).
arr.InsertAt(1, new CAge(30));  // New element 1
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("InsertAt example: ") << &arr << _T("\n");
#endif

Les résultats de ce programme sont les suivantes :

InsertAt example: A CObArray with 3 elements

[0] = a CAge at $45C8 21

[1] = a CAge at $4646 30

[2] = a CAge at $4606 40