Compartilhar via


CAtlArray::Append

Chamar este método para adicionar o conteúdo de uma matriz ao final da outra.

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

Parâmetros

  • aSrc
    A matriz para acrescentar.

Valor de retorno

Retorna o índice do primeiro elemento acrescentado.

Comentários

Os elementos da matriz fornecida são adicionados ao final da matriz existente.Se necessário, a memória será atribuída para acomodar os novos elementos.

Matrizes devem ser do mesmo tipo, e não é possível seacrescentar- uma matriz.

Em compilações de depuração, um ATLASSERT será gerado se o argumento de CAtlArray uma matriz não é válido ou se aSrc refere-se ao mesmo objeto.Em construções de versão, os argumentos inválidos pode resultar em comportamento imprevisível.

Exemplo

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

Cabeçalho: atlcoll.h

Consulte também

Referência

Classe de CAtlArray

CAtlArray::InsertArrayAt