若要檢視英文版的文章,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

CObArray::InsertAt

 

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


      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

需求

Header: afxcoll.h

顯示: