Condividi tramite


CAtlArray::Append

Chiamare questo metodo per aggiungere il contenuto di una matrice alla fine di un altro.

size_t Append(
   const CAtlArray< E, ETraits >& aSrc 
);

Parametri

  • aSrc
    La matrice da aggiungere.

Valore restituito

Restituisce l'indice del primo elemento aggiunto.

Note

Gli elementi della matrice fornita aggiunti alla fine della matrice esistente.Se necessario, la memoria verrà allocata per inserire i nuovi elementi.

Le matrici devono essere dello stesso tipo e non è possibile aggiungere una matrice a se stesso.

Nelle build di debug, un ATLASSERT viene generato se l'argomento CAtlArray non è una matrice valida o se aSrc si riferisce allo stesso oggetto.Nelle build di rilascio, gli argomenti non validi possono produrre un comportamento imprevedibile.

Esempio

// Declare two integer arrays
CAtlArray<int> iArray1,iArray2;

iArray1.Add(1);   // element 0
iArray1.Add(2);   // element 1

iArray2.Add(3);   // element 0
iArray2.Add(4);   // element 1

// Append iArray2 to iArray1
iArray1.Append(iArray2);

ATLASSERT(iArray1.GetCount() == 4);   

Requisiti

Header: atlcoll.h

Vedere anche

Riferimenti

Classe di CAtlArray

CAtlArray::InsertArrayAt