CObArray::SetAtGrow

Artigo
02/25/2013

Define o elemento de matriz no índice especificado.

void SetAtGrow(
   INT_PTR nIndex,
   CObject* newElement 
);

Parâmetros

nIndex
Um índice inteiro que é maior ou igual a 0.
newElement
O ponteiro do objeto a ser adicionado a essa matriz.Um valor de NULO é permitido.

Comentários

A matriz aumenta automaticamente se necessário (isto é, o limite superior é ajustado para acomodar o novo elemento).

A tabela a seguir mostra outras funções de membro que são semelhantes a CObArray::SetAtGrow.

Classe	Função de membro
CByteArray	void SetAtGrow( INT_PTR nIndex, BYTE newElement ); *throw( CMemoryException );**
CDWordArray	void SetAtGrow( INT_PTR nIndex, DWORD newElement ); *throw( CMemoryException );**
CPtrArray	void SetAtGrow( INT_PTR nIndex, void* newElement ); *throw( CMemoryException );**
CStringArray	void SetAtGrow( INT_PTR nIndex, LPCTSTR newElement ); *throw( CMemoryException );**
CUIntArray	void SetAtGrow( INT_PTR nIndex, UINT newElement ); *throw( CMemoryException );**
CWordArray	void SetAtGrow( INT_PTR nIndex, WORD newElement ); *throw( CMemoryException );**

Exemplo

Consulte CObList::CObList para uma listagem da classe de CAge usada em todos os exemplos de coleção.

CObArray arr;

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

Os resultados do programa é a seguinte:

SetAtGrow example: A CObArray with 4 elements

[0] = a CAge at $47C0 21

[1] = a CAge at $4800 40

[2] = NULL

[3] = a CAge at $4840 65