CObArray::InsertAt

發行項
02/28/2013

插入項目 (或另一個檔案中的所有元素的陣列) 中的指定索引。

void InsertAt(
   INT_PTR nIndex,
   CObject* newElement,
   INT_PTR nCount = 1 
);
void InsertAt(
   INT_PTR nStartIndex,
   CObArray* pNewArray 
);

參數

nIndex
的值可能大於的整數索引。 GetUpperBound傳回。
newElement
在陣列中放置的 CObject 指標。值 NULLnewElement 允許。
nCount
應該插入項目的次數 (預設值為 1)。
nStartIndex
的值可能大於的整數索引。 GetUpperBound傳回。
pNewArray
包含項目會加入至陣列的另一個陣列。

備註

InsertAt 第一版插入項目 (或項目的多個複本) 中的指定索引的陣列。在處理序中，它會將移位 (索引) 為現有項目，在這個索引，並將其上方的所有項目。

第二種版本中插入另一個 CObArray 集合中所有的項目開始， nStartIndex 位置。

SetAt 函式，相較之下，取代指定的陣列元素，且不會將任何項目。

下表顯示類似 CObArray::InsertAt的其他成員函式。

類別	成員函式
CByteArray	void InsertAt( INT_PTR nIndex, BYTE newElement, int nCount=1 ); *擲回 (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CByteArray* pNewArray); *擲回 (CMemoryException);**
CDWordArray	void InsertAt( INT_PTR nIndex, DWORD newElement, int nCount=1 ); *擲回 (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CDWordArray* pNewArray); *擲回 (CMemoryException);**
CPtrArray	void InsertAt( INT_PTR nIndex, void* newElement, int nCount=1 ); *擲回 (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CPtrArray* pNewArray); *擲回 (CMemoryException);**
CStringArray	void InsertAt( INT_PTR nIndex, LPCTSTR newElement, int nCount=1 ); *擲回 (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CStringArray* pNewArray); *擲回 (CMemoryException);**
CUIntArray	void InsertAt( INT_PTR nIndex, UINT newElement, int nCount=1 ); *擲回 (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CUIntArray* pNewArray); *擲回 (CMemoryException);**
CWordArray	void InsertAt( INT_PTR nIndex, WORD newElement, int nCount=1 ); *擲回 (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CWordArray* pNewArray); *擲回 (CMemoryException);**

範例

針對所有集合範例的 CAge 類別的目錄參閱 CObList::CObList 。

CObArray arr;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1 (will become 2).
arr.InsertAt(1, new CAge(30));  // New element 1
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("InsertAt example: ") << &arr << _T("\n");
#endif

本程式的結果如下:

InsertAt example: A CObArray with 3 elements

[0] = a CAge at $45C8 21

[1] = a CAge at $4646 30

[2] = a CAge at $4606 40