Share via


CObArray::SetAt

establece el elemento de matriz en el índice especificado.

void SetAt(
   INT_PTR nIndex,
   CObject* newElement 
);

Parámetros

  • nIndex
    Un índice entero que es mayor o igual que 0 y menor que o igual al valor devuelto por GetUpperBound.

  • newElement
    El puntero de objeto que se va a insertar en esta matriz.Se permite un valor NULL.

Comentarios

SetAt no hará la matriz crezca.Utilice SetAtGrow si desea que la matriz crezcan automáticamente.

Debe asegurarse de que su valor de índice representa una posición válida en la matriz.Si está fuera de los límites, la versión de depuración de la biblioteca aserciones.

La tabla siguiente se muestran otras funciones miembro que son similares a CObArray::SetAt.

Clase

Función miembro

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

Ejemplo

Vea CObList:: CObList para una lista de la clase de CAge utilizada en todos los ejemplos de la colección.

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      

Los resultados de este programa son los siguientes:

SetAt example: A CObArray with 2 elements

[0] = a CAge at $47E0 30

[1] = a CAge at $47A0 40

Requisitos

encabezado: afxcoll.h

Vea también

Referencia

Clase de CObArray

Gráfico de jerarquía

CObArray::GetAt

CObArray::SetAtGrow

CObArray::ElementAt

CObArray::operator [ ]