CArray::InsertAt

Die erste Version von InsertAt wird ein Element (oder mehrere Kopien eines Elements) zu einem angegebenen Index in einem Array ein.

void InsertAt(
   INT_PTR nIndex,
   ARG_TYPE newElement,
   INT_PTR nCount = 1 
);
void InsertAt(
   INT_PTR nStartIndex,
   CArray* pNewArray 
);

Parameter

  • nIndex
    Ein ganzzahlige Index, der möglicherweise größer ist, als Wert zurückgegebenen Daten GetUpperBound zurück.

  • ARG_TYPE
    Vorlagenparameter, der den Typ der Elemente in diesem Array angibt.

  • newElement
    Das in diesem Array abgelegt werden, Element.

  • 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

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 CArray-Auflistung ein beginnend bei nStartIndex Position.

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

Beispiel

// example for CArray::InsertAt

CArray<CPoint,CPoint> ptArray;

ptArray.Add(CPoint(10,20));   // Element 0
ptArray.Add(CPoint(30,40));   // Element 1 (will become element 2)
ptArray.InsertAt(1, CPoint(50,60));   // New element 1      

Anforderungen

Header: afxtempl.h

Siehe auch

Referenz

CArray-Klasse

Hierarchien-Diagramm

CArray::GetUpperBound

CArray::SetAt

CArray::RemoveAt