The first version of InsertAt inserts one element (or multiple copies of an element) at a specified index in an array. In the process, it shifts up (by incrementing the index) the existing element at this index, and it shifts up all the elements above it.
The second version inserts all the elements from another CArray collection, starting at the nStartIndex position.
The SetAt function, in contrast, replaces one specified array element and does not shift any elements.
void InsertAt( int nIndex, ARG_TYPE newElement, int nCount = 1 );
throw( CMemoryException );
void InsertAt( int nStartIndex, CArray* pNewArray );
throw( CMemoryException );
| Header file: | Afxtempl.h |
| Platforms: | |
| Versions: | 1.0 and later |
| Complete documentation: | Visual C++ documentation |
CArray Overview, CArray Member Functions, GetUpperBound, CArray::SetAt, CArray::RemoveAt