CObArray::InsertAt

Artikel
02/26/2013

Fügt ein Element (oder alle Elemente in anderen Array) zu einem angegebenen Index ein.

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

Parameter

nIndex
Ein ganzzahlige Index, der möglicherweise größer ist, als Wert zurückgegebenen Daten GetUpperBound zurück.
newElement
Der in diesem Array abgelegt werden CObject Zeiger.newElement des Werts NULL zulässig.
nCount
Die Häufigkeit dieses Element eingefügt werden soll (Standards bis 1).
nStartIndex
Ein ganzzahlige Index, der möglicherweise größer ist, als Wert zurückgegebenen Daten GetUpperBound zurück.
pNewArray
Ein anderes Array, das die enthält zu diesem Array Elemente hinzugefügt werden.

Hinweise

Die erste Version von InsertAt wird ein Element (oder mehrere Kopien eines Elements) zu einem angegebenen Index in einem Array ein.Im Prozess rückt es in (durch Erhöhen des Index) das vorhandene Element an diesem Index, und es rückt in alle Elemente darüber.

Die zweite Version fügt alle Elemente aus einer anderen CObArray-Auflistung ein beginnend bei nStartIndex Position.

Die Funktion SetAt dagegen ersetzt ein angegebenes Arrayelement und verschiebt keine Elemente.

In der folgenden Tabelle werden andere Memberfunktionen auf, die mit CObArray::InsertAt ähneln.

Klasse	Memberfunktion
CByteArray	void InsertAt( INT_PTR nIndex, BYTE newElement, int nCount=1 ); *Throw (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CByteArray* pNewArray); *Throw (CMemoryException);**
CDWordArray	void InsertAt( INT_PTR nIndex, DWORD newElement, int nCount=1 ); *Throw (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CDWordArray* pNewArray); *Throw (CMemoryException);**
CPtrArray	void InsertAt( INT_PTR nIndex, void* newElement, int nCount=1 ); *Throw (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CPtrArray* pNewArray); *Throw (CMemoryException);**
CStringArray	void InsertAt( INT_PTR nIndex, LPCTSTR newElement, int nCount=1 ); *Throw (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CStringArray* pNewArray); *Throw (CMemoryException);**
CUIntArray	void InsertAt( INT_PTR nIndex, UINT newElement, int nCount=1 ); *Throw (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CUIntArray* pNewArray); *Throw (CMemoryException);**
CWordArray	void InsertAt( INT_PTR nIndex, WORD newElement, int nCount=1 ); *Throw (CMemoryException); void InsertAt( INT_PTR** nStartIndex, CWordArray* pNewArray); *Throw (CMemoryException);**

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse, die in allen Auflistungsbeispielen verwendet wird.

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

Die Ergebnisse dieses Programms sind, wie folgt:

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