Partilhar via


CAtlArray::InsertAt

telefonar Esse método para inserir um novo elemento (ou várias cópias de um elemento) no objeto 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 inseridas.

  • nCount
    O número de elementos para adicionar.

Comentários

Insere um ou mais elementos na matriz, iniciando no índice iElement. Os elementos existentes são movidos para evitar a sobregravação.

Em compilações de depurar, será gerado um ATLASSERT se o CAtlArray o objeto é inválido, o número de elementos a serem adicionados é zero ou é muito grande para a matriz para conter o número de elementos combinado. Em compilações de varejo, 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 CAtlArray

CAtlArray::Add

Outros recursos

CAtlArray membros