Freigeben über


CAtlArray::InsertAt

Rufen Sie diese Methode auf, um ein neues Element (oder mehrere Kopien eines Elements) in das Arrayobjekt einzufügen.

void InsertAt( 
   size_t iElement, 
   INARGTYPE element, 
   size_t nCount = 1  
);

Parameter

  • iElement
    Der Index, wo das Element bzw. die Elemente eingefügt werden sollen.

  • element
    Der Wert des einzufügenden Elements oder der Elemente.

  • nCount
    Die Anzahl von Elementen hinzuzufügen.

Hinweise

Fügt eine oder mehrere Elemente in das Array an und beginnt am Index iElement. Vorhandene Elemente werden verschoben, um überschrieben werden zu vermeiden.

In Debugbuilds wird ein ATLASSERT, wenn das Objekt CAtlArray ungültig ist, die Anzahl der Elemente hinzugefügt werden ausgelöst, ist null, oder die kombinierte Anzahl der Elemente ist zu groß, damit das Array enthält. In den Verkaufsversionsbuildern verursacht möglicherweise die Übergabe von Parametern ungültigen unvorhersehbare Ergebnisse.

Beispiel

// Declare an array of integers
CAtlArray<int> iBuffer;

// Add elements to the array 
for (int b = 0; b < 10; b++)
{
   iBuffer.Add(0);
}

// Instert ten 1's into the array 
// at position 5
iBuffer.InsertAt(5, 1, 10);   

Anforderungen

Header: atlcoll.h

Siehe auch

Referenz

CAtlArray Class

CAtlArray::Add