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