Partilhar via


CAtlArray::RemoveAt

telefonar 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 é diminuído, mas não está sendo liberada memória até que uma telefonar para CAtlArray::FreeExtra é feita.

Em compilações de depurar, será gerado um ATLASSERT se o CAtlArray objeto inválido, ou se o total combinado de iElement e nCount excede o número total de elementos na matriz. Em compilações de varejo, 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 CAtlArray

CAtlArray::RemoveAll

Outros recursos

CAtlArray membros