CObArray::InsertAt

Artykuł
02/27/2013

Wstawia element (lub wszystkie elementy tablicy innego) pod określonym indeksem.

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

Parametry

nIndex
Indeks może być większa niż wartość zwracana przez całkowitą GetUpperBound.
newElement
CObject Wskaźnika należy umieścić w tej tablicy.A newElement wartości NULL jest dozwolona.
nCount
Ile razy ten element powinien być wstawiony (domyślnie 1).
nStartIndex
Indeks może być większa niż wartość zwracana przez całkowitą GetUpperBound.
pNewArray
Innym tablica zawiera elementy, które mają zostać dodane do tej tablicy.

Uwagi

Pierwsza wersja InsertAt Wstawia jeden element (lub wiele kopii elementu) w określonym indeksem tablicy.W procesie, przesuwa (zwiększając wartość indeksu) istniejącego elementu w tym indeksie, a przesuwa wszystkich elementów powyżej.

Druga wersja wstawia wszystkie elementy z innego CObArray kolekcji, począwszy od nStartIndex pozycji.

SetAt Funkcji, natomiast zastępuje jeden element tablicy określonej i nie zmienia żadnych elementów.

W poniższej tabeli przedstawiono funkcje, które są podobne do innego członka CObArray::InsertAt.

Klasa	Funkcja Członkowskie
CByteArray	void InsertAt( INT_PTR nIndex, BYTE newElement, int nCount=1 ); rzut CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CByteArray* pNewArray ); rzut CMemoryException ;**
CDWordArray	void InsertAt( INT_PTR nIndex, DWORD newElement, int nCount=1 ); rzut CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CDWordArray* pNewArray ); rzut CMemoryException ;**
CPtrArray	void InsertAt( INT_PTR nIndex, void* newElement, int nCount=1 ); rzut CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CPtrArray* pNewArray ); rzut CMemoryException ;**
CStringArray	void InsertAt( INT_PTR nIndex, LPCTSTR newElement, int nCount=1 ); rzut CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CStringArray* pNewArray ); rzut CMemoryException ;**
CUIntArray	void InsertAt( INT_PTR nIndex, UINT newElement, int nCount=1 ); rzut CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CUIntArray* pNewArray ); rzut CMemoryException ;**
CWordArray	void InsertAt( INT_PTR nIndex, WORD newElement, int nCount=1 ); rzut CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CWordArray* pNewArray ); rzut CMemoryException ;**

Przykład

Zobacz CObList::CObList listę CAge klasy używane we wszystkich przykładach kolekcji.

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

Wyniki tego programu są następujące:

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