CObArray::SetAt

Artigo
02/25/2013

Define o elemento de matriz no índice especificado.

void SetAt(
   INT_PTR nIndex,
   CObject* newElement 
);

Parâmetros

nIndex
Um índice inteiro que é maior ou igual a 0 e menor ou igual ao valor retornado por GetUpperBound.
newElement
O ponteiro do objeto a ser inserido em esta matriz.Um valor de NULO é permitido.

Comentários

SetAt não fará com que a matriz aumenta.Use SetAtGrow se você desejar que a matriz aumentarem automaticamente.

Você deve garantir que o valor de índice representa uma posição válido na matriz.Se está fora dos limites, então a versão de depuração de biblioteca afirma.

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

Classe	Função de membro
CByteArray	void SetAt( INT_PTRnIndex, BYTE newElement );
CDWordArray	void SetAt( INT_PTRnIndex, DWORD newElement );
CPtrArray	void SetAt( INT_PTRnIndex, void* newElement );
CStringArray	void SetAt( INT_PTRnIndex, LPCTSTR newElement );
CUIntArray	void SetAt( INT_PTRnIndex, UINT newElement );
CWordArray	void SetAt( INT_PTRnIndex, WORD newElement );

Exemplo

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

CObArray arr;
CObject* pa;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
if ((pa = arr.GetAt(0)) != NULL)
{
   arr.SetAt(0, new CAge(30));  // Replace element 0.
   delete pa; // Delete the original element at 0.
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("SetAt example: ") << &arr << _T("\n");
#endif

Os resultados do programa é a seguinte:

SetAt example: A CObArray with 2 elements

[0] = a CAge at $47E0 30

[1] = a CAge at $47A0 40