CAtlArray::InsertAt

Llame a este método para insertar un nuevo elemento (o varias copias de un elemento) en el objeto array.

void InsertAt(
   size_t iElement,
   INARGTYPE element,
   size_t nCount = 1 
);

Parámetros

• iElement
  El índice donde es incrustar el elemento o elementos.

• element
  El valor del elemento o elementos que se van a insertar.

• nCount
  Número de elementos que se van a agregar.

Comentarios

Inserta uno o más elementos en la matriz, comenzando en el índice iElement.Los elementos existentes se mueven para evitar sobrescribir.

En las compilaciones de depuración, un ATLASSERT se generará si el objeto de CAtlArray no es válido, el número de elementos que se van a agregar es cero, o el número combinado de elementos es demasiado grande para que la matriz contiene.En las versiones de lanzamiento, pasar parámetros no válidos puede causar resultados imprevisibles.

Ejemplo

// Declare an array of integers
CAtlArray<int> iBuffer;

// Add elements to the array
for (int b = 0; b < 10; b++)
{
   iBuffer.Add(0);
}

// Instert ten 1's into the array
// at position 5
iBuffer.InsertAt(5, 1, 10);   

Requisitos

encabezado: atlcoll.h

Vea también

Referencia

Clase CAtlArray

CAtlArray::Add