CObArray::InsertAt

privatevoidInsertAt (IntnIndex,CObjectNewElement,IntnCount=1);
werfen ( CMemoryException );

privatevoid InsertAt ( Int nStartIndex, CObArray * pNewArray );
werfen ( CMemoryException );

Parameter

nIndex

Einen Ganzzahlenindex, der größer als der Wert von GetUpperBound zurückgegeben werden kann.

newElement

Die CObject -Zeiger in diesem Array platziert werden. Ein NewElement der Wert NULL ist zulässig.

nCount

Die Anzahl der Zeiten, die dieses Element sollten eingefügt (Standard: 1).

nStartIndex

Einen Ganzzahlenindex, der größer als der Wert von GetUpperBound zurückgegeben werden kann.

pNewArray

Ein weiteres Array, das mit Elementen in diesem Array hinzugefügt werden.

Bemerkungen

Die erste Version von InsertAt fügt ein Element (oder mehrere Kopien eines Elements) an einem angegebenen Index in ein Array. Dabei verschiebt es sich (durch das Inkrementieren des Indexes) das vorhandene Element am Index, und es verschiebt alle Elemente darüber.

Die zweite Version fügt alle Elemente aus einem anderen CObArray Auflistung, beginnend an der Position nStartIndex.

Die Funktion SetAt demgegenüber ersetzt eine angegebene Arrayelement und wird keine Elemente verschieben.

Die folgende Tabelle zeigt andere Memberfunktionen, die ähnlich wie CObArray::InsertAt sind.

Klasse Member-Funktion
CByteArray void InsertAt (Int nIndex, BYTE &NewElement, Int nCount=1);
Nbsp;werfen ( CMemoryException );

void InsertAt (Int nStartIndex, CByteArray * p&NewArray );
Nbsp;werfen ( CMemoryException );

CDWordArray void InsertAt (Int nIndex, DWORD &NewElement, Int nCount=1);
Nbsp;werfen ( CMemoryException );

void InsertAt (Int nStartIndex, CDWordArray * p&NewArray );
Nbsp;werfen ( CMemoryException );

CPtrArray void InsertAt (Int nIndex, Void * &NewElement, Int nCount=1);
Nbsp;werfen ( CMemoryException );

void InsertAt (Int nStartIndex, CPtrArray * p&NewArray );
Nbsp;werfen ( CMemoryException );

CStringArray void InsertAt (Int nIndex, LPCTSTR &NewElement, Int nCount=1);
Nbsp;werfen ( CMemoryException );

void InsertAt (Int nStartIndex, CStringArray * p&NewArray );
Nbsp;werfen ( CMemoryException );

CUIntArray void InsertAt (Int nIndex, UI&NT NewElement, Int nCount=1);
Nbsp;werfen ( CMemoryException );

void InsertAt (Int nStartIndex, CUIntArray * p&NewArray );
Nbsp;werfen ( CMemoryException );

CWordArray void InsertAt (Int nIndex, WORD &NewElement, Int nCount=1);
Nbsp;werfen ( CMemoryException );

void InsertAt (Int nStartIndex, CWordArray * p&NewArray );
Nbsp;werfen ( CMemoryException );


Beispiel

Eine Liste der CObList::CObList finden Sie die CAge in allen Beispielen der Auflistung verwendete Klasse.

/ / Beispiel für CObArray::InsertAt

Nbsp;  CObArray Array;
    
    Array.Fügen Sie hinzu (neue Käfig (21)); / / Element 0
    Array.Fügen Sie hinzu (neue Käfig (40)); / / Element 1 (werden 2).
    Array.InsertAt (1, neue Käfig (30));  / / Neues Element 1
# ifdef _DEBUG
    afxDump.SetDepth (1);
    AfxDump << "InsertAt-Beispiel:" << & Array << "\n";
# endif

Die Ergebnisse aus diesem Programm sind wie folgt:

InsertAt-Beispiel: ein CObArray mit 3 Elementen
 &Nbsp;  [0] = Käfig bei 45 C $8 21
    [1] einen Käfig bei $4646 = 30
    [2] einen Käfig bei $4606 = 40

Übersicht über die CObArrayMember der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CObArray::SetAt, CObArray::RemoveAt

Index