CArray::InsertAt

Artykuł
02/27/2013

Pierwsza wersja InsertAt Wstawia jeden element (lub wiele kopii elementu) w określonym indeksem tablicy.

void InsertAt(
   INT_PTR nIndex,
   ARG_TYPE newElement,
   INT_PTR nCount = 1 
);
void InsertAt(
   INT_PTR nStartIndex,
   CArray* pNewArray 
);

Parametry

nIndex
Indeks może być większa niż wartość zwracana przez całkowitą GetUpperBound.
ARG_TYPE
Parametr szablonu, określając typ elementów w tej tablicy.
newElement
Element, które mają być umieszczone w tej tablicy.
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

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 CArray kolekcji, począwszy od nStartIndex pozycji.

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

Przykład

// example for CArray::InsertAt

CArray<CPoint,CPoint> ptArray;

ptArray.Add(CPoint(10,20));   // Element 0
ptArray.Add(CPoint(30,40));   // Element 1 (will become element 2)
ptArray.InsertAt(1, CPoint(50,60));   // New element 1