Partilhar via


CAtlArray::InsertAt

Chamar esse método para inserir um novo elemento (ou várias cópias de um elemento) no objeto de matriz.

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

Parâmetros

  • iElement
    O índice onde o elemento ou elementos devem ser inseridos.

  • element
    O valor do elemento ou elementos a serem inseridos.

  • nCount
    O número de elementos para adicionar.

Comentários

Insere um ou mais elementos na matriz, começando no índice iElement.Elementos existentes são movidos para evitar ser substituído.

Em compilações de depuração, um ATLASSERT será gerado se o objeto de CAtlArray é inválido, o número de elementos a serem adicionados é zero, ou combinado o número de elementos é muito grande para que a matriz contém.Em construções varejistas, passar parâmetros inválidos pode causar resultados imprevisíveis.

Exemplo

// 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

Cabeçalho: atlcoll.h

Consulte também

Referência

Classe de CAtlArray

CAtlArray::Add