Partilhar via


CAtlArray::RemoveAt

Chamar esse método para remover um ou mais elementos da matriz.

void RemoveAt(
   size_t iElement,
   size_t nCount = 1 
);

Parâmetros

  • iElement
    O índice do primeiro elemento para remover.

  • nCount
    O número de elementos para remover.

Comentários

Remove um ou mais elementos da matriz.Todos os elementos restantes são deslocados para baixo.O limite superior é decrescido, mas não a memória é liberada até que uma chamada a CAtlArray::FreeExtra é feito.

Em compilações de depuração, um ATLASSERT será gerado se o objeto de CAtlArray é inválido, ou se o combinação total de iElement e de nCount excede o número total de elementos da matriz.Em construções varejistas, os parâmetros inválidos podem causar resultados imprevisíveis.

Exemplo

// Declare an array of chars
CAtlArray<char> cMyArray;

// Add ten elements to the array
for (int a = 0; a < 10; a++)
{
   cMyArray.Add('*');
}

// Remove five elements starting with
// the element at position 1
cMyArray.RemoveAt(1, 5);

// Free memory
cMyArray.FreeExtra();

// Confirm size of array
ATLASSERT(cMyArray.GetCount() == 5);   

Requisitos

Cabeçalho: atlcoll.h

Consulte também

Referência

Classe de CAtlArray

CAtlArray::RemoveAll