Partager via


CAtlArray::Append

Appelez cette méthode pour ajouter du contenu d'un tableau à la fin de les autres.

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

Paramètres

  • aSrc
    Tableau à ajouter.

Valeur de retour

Retourne l'index du premier élément ajouté.

Notes

Les éléments du tableau fournies sont ajoutés à la fin de la tableau existant.Si nécessaire, la mémoire est allouée pour s'adapter aux nouveaux éléments.

Les tableaux doivent être du même type, et il n'est pas possible d'ajouter un tableau à lui-même.

Dans les versions debug, un ATLASSERT sera déclenché si l'argument d' CAtlArray n'est pas un tableau valide ou si aSrc fait référence au même objet.Dans les versions release, les arguments non valides peuvent entraîner le comportement imprévisible.

Exemple

// 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);   

Configuration requise

Header: atlcoll.h

Voir aussi

Référence

Classe de CAtlArray

CAtlArray::InsertArrayAt