недійсними InsertAt ( int nIndex, CObject * newElement, int nCount = 1 );
кинути ( CMemoryException );
недійснимиInsertAt (nStartIndex,CObArray *intpNewArray);
кинути ( 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 ); |
| CDWordArray | до втрати I&nsertAt (int nIndex, DWORD newElement, int nCount=1); nbsp;кинути ( CMemoryException );
до втрати InsertAt (int nStartIndex, CDWordArray * p&NewArray ); |
| CPtrArray | до втрати I&nsertAt (int nIndex, порожнечу * newElement, int nCount=1); nbsp;кинути ( CMemoryException );
до втрати InsertAt (int nStartIndex, CPtrArray * p&NewArray ); |
| CStringArray | до втрати I&nsertAt (int nIndex, LPCTSTR newElement, int nCount=1); nbsp;кинути ( CMemoryException );
до втрати InsertAt (int nStartIndex, CStringArray * p&NewArray ); |
| CUIntArray | до втрати InsertAt (int nIndex, UI&NT newElement, int nCount=1); nbsp;кинути ( CMemoryException );
до втрати InsertAt (int nStartIndex, CUIntArray * p&NewArray ); |
| CWordArray | до втрати I&nsertAt (int nIndex, слово newElement, int nCount=1); nbsp;кинути ( CMemoryException );
до втрати InsertAt (int nStartIndex, CWordArray * p&NewArray ); |
Приклад
Див 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 С 8 21
[1] = клітці в $4646 30
[2] = клітці в $4606 40
Огляд CObArray | Члени класу | Ієрархічна діаграма
Дивіться також CObArray::SetAt, CObArray::RemoveAt