CObArray::InsertAt

Článek
03/04/2013

Vloží zadaný index prvku (nebo všechny prvky v jiném poli).

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

Parametry

nIndex
Integer index, který může být větší než hodnota vrácená GetUpperBound .
newElement
CObject Ukazatel do tohoto pole.A newElement hodnoty NULL je povoleno.
nCount
Kolikrát tento prvek by měl být vložen (výchozí nastavení je 1).
nStartIndex
Integer index, který může být větší než hodnota vrácená GetUpperBound .
pNewArray
Jiné pole, které obsahuje prvky, které mají být přidány do tohoto pole.

Poznámky

První verze InsertAt vloží jeden prvek (nebo více kopií element) do určeného indexu v matici.V procesu, posune (zvětšením index) existujícího prvku tohoto indexu, a posune nahoru všechny prvky nad ní.

Druhá verze vloží všechny prvky z jiné CObArray kolekce počínaje nStartIndex pozice.

SetAt Funkce naopak nahrazuje jeden prvek určeného pole a není shift žádné prvky.

Následující tabulka obsahuje další členské funkce, které jsou podobné CObArray::InsertAt .

Třída	Členská funkce
CByteArray	void InsertAt( INT_PTR nIndex, BYTE newElement, int nCount=1 ); vyvoláním CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CByteArray* pNewArray ); vyvoláním CMemoryException ;**
CDWordArray	void InsertAt( INT_PTR nIndex, DWORD newElement, int nCount=1 ); vyvoláním CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CDWordArray* pNewArray ); vyvoláním CMemoryException ;**
CPtrArray	void InsertAt( INT_PTR nIndex, void* newElement, int nCount=1 ); vyvoláním CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CPtrArray* pNewArray ); vyvoláním CMemoryException ;**
CStringArray	void InsertAt( INT_PTR nIndex, LPCTSTR newElement, int nCount=1 ); vyvoláním CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CStringArray* pNewArray ); vyvoláním CMemoryException ;**
CUIntArray	void InsertAt( INT_PTR nIndex, UINT newElement, int nCount=1 ); vyvoláním CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CUIntArray* pNewArray ); vyvoláním CMemoryException ;**
CWordArray	void InsertAt( INT_PTR nIndex, WORD newElement, int nCount=1 ); vyvoláním CMemoryException ; void InsertAt( INT_PTR** nStartIndex, CWordArray* pNewArray ); vyvoláním CMemoryException ;**

Příklad

Viz CObList::CObList seznam CAge třídy použitá v příkladech všechny kolekce.

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

Výsledky z tohoto programu jsou následující:

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