CObArray::InsertAt

void InsertAt ( int nIndex, от CObject * newElement, int nCount = 1 );
бросить ( CMemoryException );

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

Параметры

nIndex

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

newElement

Указатель CObject в этом массиве. Допускается newElement значения NULL.

nCount

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

nStartIndex

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

pNewArray

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

Примечания

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

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

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

В следующей таблице приведены другие функции-члены, которые похожи на CObArray::InsertAt.

Класс Функция-член
CByteArray аннулировать I&nsertAt (int nIndex, БАЙТ newElement, int nCount=1);
 nbsp;бросить ( CMemoryException );

аннулировать InsertAt (int nStartIndex, CByteArray * p&NewArray );
 nbsp;бросить ( CMemoryException );
CDWordArray аннулировать I&nsertAt (int nIndex, DWORD newElement, int nCount=1);
 nbsp;бросить ( CMemoryException );

аннулировать InsertAt (int nStartIndex, CDWordArray * p&NewArray );
 nbsp;бросить ( CMemoryException );
CPtrArray аннулировать I&nsertAt (int nIndex, void * newElement, int nCount=1);
 nbsp;бросить ( CMemoryException );

аннулировать InsertAt (int nStartIndex, CPtrArray * p&NewArray );
 nbsp;бросить ( CMemoryException );
CStringArray аннулировать I&nsertAt (int nIndex, LPCTSTR newElement, int nCount=1);
 nbsp;бросить ( CMemoryException );

аннулировать InsertAt (int nStartIndex, CStringArray * p&NewArray );
 nbsp;бросить ( CMemoryException );
CUIntArray аннулировать InsertAt (int nIndex, UI&NT newElement, int nCount=1);
 nbsp;бросить ( CMemoryException );

аннулировать InsertAt (int nStartIndex, CUIntArray * p&NewArray );
 nbsp;бросить ( CMemoryException );
CWordArray аннулировать I&nsertAt (int nIndex, слово newElement, int nCount=1);
 nbsp;бросить ( CMemoryException );

аннулировать InsertAt (int nStartIndex, CWordArray * p&NewArray );
 nbsp;бросить ( CMemoryException );

Пример

Смотрите CObList::CObList список CAge класс, используемая во всех примерах коллекции.

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

nbsp;  CObArray массив;
    
    массив.Добавления (новые Кейдж (21)); / / Элемент 0
    массив.Добавления (новые Кейдж (40)); / / Элемент 1 (станет 2).
    массив.InsertAt (1, новый Кейдж (30));  / / Новый элемент 1
# ifdef _DEBUG
    afxDump.SetDepth (1);
    afxDump << "InsertAt пример:" << & массив << «\n»;
# endif

Результаты этой программы заключаются в следующем:

Пример I&nsertAt: CObArray с 3 элемента
 nbsp;  [0] = клетке на $45 C 8 21
    [1] = Кейдж на $4646 30
    [2] = Кейдж на $4606 40

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

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

Index