CAtlArray::Append

Llame a este método para agregar el contenido de una matriz al final de otro.

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

Parámetros

• aSrc
  La matriz para anexar.

Valor devuelto

Devuelve el índice del primer elemento anexado.

Comentarios

Los elementos de la matriz proporcionado se agregan al final de la matriz existente.Si es necesario, la memoria se asignada para adaptarse a los nuevos elementos.

Las matrices deben ser del mismo tipo, y no es posible anexar una matriz a sí mismo.

En compilaciones de depuración, un ATLASSERT se generará si el argumento de CAtlArray no es una matriz válido o si aSrc hace referencia al mismo objeto.En las versiones de lanzamiento, los argumentos no válidos pueden causar un comportamiento imprevisible.

Ejemplo

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

Requisitos

encabezado: atlcoll.h

Vea también

Referencia

Clase CAtlArray

CAtlArray::InsertArrayAt