CArray::InsertAt

nieważne InsertAt ( int nIndex, ARG_TYPE newElement, int nCount = 1 );
rzut ( CMemoryException );

nieważne InsertAt ( int nStartIndex, CArray * pNewArray );
rzut ( CMemoryException );

Parametry

nIndex

Indeks całkowitą, która może być większa niż wartość zwracany przez GetUpperBound.

ARG_TYPE

Szablon parametr określający typ elementów w tej tablicy.

newElement

Element mają być umieszczone w tej tablicy.

nCount

Liczba godzin, które ten element powinien być wstawione (domyślnie 1).

nStartIndex

Indeks całkowitą, która może być większa niż wartość zwracany przez GetUpperBound.

pNewArray

Innym tablicy, który zawiera elementy mają zostać dodane do tej tablicy.

Uwagi

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

Druga wersja wstawia wszystkie elementy z innej kolekcji CArray , począwszy od pozycji nStartIndex.

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

Przykład

/ / przykład CArray::InsertAt

CArraylt;CPoint, CPoint > ptArray;

ptArray.Add(CPoint(10,20));   / / Element 0
ptArray.Add(CPoint(30,40));   / / Element 1 (będzie stać się elementem 2)
ptArray.InsertAt (1, CPoint(50,60));   / / Nowego elementu 1

Omówie&nie CArray |nbsp; Klasa członków | Wykres hierarchii

Zobacz też GetUpperBound, CArray::SetAt, CArray::RemoveAt