Partilhar via


CObArray::Add

Adiciona um novo elemento ao participante de uma matriz, aumentando a matriz por 1.

INT_PTR Add(
   CObject* newElement 
);

Parâmetros

  • newElement
    The CObject ponteiro para ser adicionado a essa matriz.

Valor de retorno

O índice do elemento adicionado.

Comentários

If SetSize tiver sido usado com um nGrowBy é possível alocar o valor maior que 1 e, em seguida, para memória extra. No entanto, o limite superior será aumenta em 1 somente.

A tabela a seguir mostra outras funções de membro semelhantes a CObArray::Add.

Classe

Função de membro

CByteArray

INT_PTR Add( BYTE newElement );

    Lançar (CMemoryException *);

CDWordArray

INT_PTR adicionar (DWORD newElement );

    Lançar (CMemoryException *);

CPtrArray

Adicionar INT_PTR (void * newElement );

    Lançar (CMemoryException *);

CStringArray

INT_PTR adicionar (LPCTSTR newElement );     Lançar (CMemoryException *);

INT_PTR Add(const CString& newElement);

CUIntArray

INT_PTR adicionar (UINT newElement );

    Lançar (CMemoryException *);

CWordArray

INT_PTR adicionar (palavra newElement );

    Lançar (CMemoryException *);

Exemplo

See CObList::CObList para obter uma lista do CAge classe usada em todos os exemplos de coleção.

CObArray arr;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("Add example: ") << &arr << _T("\n");
#endif      

sistema autônomo resultados deste programa são da seguinte maneira:

Add example: A CObArray with 2 elements

[0] = a CAge at $442A 21

[1] = a CAge at $4468 40

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe CObArray

Gráfico de hierarquia

CObArray::SetAt

CObArray::SetAtGrow

CObArray::InsertAt

[] CObArray::operador

Outros recursos

CObArray membros