CArray::InsertAt

voidInsertAt (intnIndex,ARG_TYPE,newElementintnCount=1);
бросить ( CMemoryException );

void InsertAt ( int nStartIndex, CArray * pNewArray );
бросить ( CMemoryException );

Параметры

nIndex

Целочисленный индекс, который может быть больше, чем значение, возвращаемое GetUpperBound.

ARG_TYPE

Параметр шаблона, указав тип элементов в этом массиве.

newElement

Элемент в этом массиве.

nCount

Количество раз, этот элемент должен быть включен (по умолчанию 1).

nStartIndex

Целочисленный индекс, который может быть больше, чем значение, возвращаемое GetUpperBound.

pNewArray

Другой массив, содержащий элементы для добавления в этот массив.

Примечания

Первая версия InsertAt вставляет один элемент (или несколько копий элемента) по указанному индексу в массиве. В этом процессе, он смещается (путем увеличения индекса) существующий элемент в этот индекс и он перекладывает все элементы над ним.

Вторая версия вставляет все элементы из другой CArray коллекции, начиная с позиции nStartIndex.

SetAt функция, наоборот, заменяет один из элементов заданного массива и не перекладывать любых элементов.

Пример

/ / Пример для CArray::InsertAt

CArraylt;CPoint, CPoint > ptArray;

ptArray.Add(CPoint(10,20));   / / Элемент 0
ptArray.Add(CPoint(30,40));   / / Элемент 1 (станет элемент 2)
ptArray.InsertAt (1, CPoint(50,60));   / / Новый элемент 1

Обзор CArray |  Члены класса | Иерархическая схема

См. также GetUpperBound, CArray::SetAt, CArray::RemoveAt