CObArray::RemoveAt

Remove um ou mais elementos começando em um índice especificado em uma matriz.

void RemoveAt(
   INT_PTR nIndex,
   INT_PTR nCount = 1 
);

Parâmetros

  • nIndex
    Um índice de inteiro é maior que ou igual a 0 e menor ou igual ao valor retornado por GetUpperBound.

  • nCount
    O número de elementos para remover.

Comentários

O processo, ele alterna para baixo de todos os elementos acima do elemento (s) removida.Ele diminui superior limite da matriz, mas não liberar memória.

Se você tentar remover mais elementos que estão contidos na matriz acima do ponto de remoção, versão de depurar de biblioteca de declarações.

The RemoveAt função remove a CObject ponteiro de matriz, mas não exclui o próprio objeto.

A tabela a seguir mostra outras funções de membro semelhantes a CObArray::RemoveAt.

Classe

Função de membro

CByteArray

RemoveAt (INT_PTR void nIndex, INT_PTR nCount = 1 );

CDWordArray

RemoveAt (INT_PTR void nIndex, INT_PTR nCount = 1 );

CPtrArray

RemoveAt (INT_PTR void nIndex, INT_PTR nCount = 1 );

CStringArray

RemoveAt (INT_PTR void nIndex, INT_PTR nCount = 1 );

CUIntArray

RemoveAt (INT_PTR void nIndex, INT_PTR nCount = 1 );

CWordArray

void RemoveAt( INT_PTRnIndex, INT_PTR nCount = 1 );

Exemplo

See CObList::CObList para obter uma lista do CAge classe usada em todos os exemplos de coleção.

CObArray arr;
CObject* pa;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
if((pa = arr.GetAt(0)) != NULL)
{
    arr.RemoveAt(0);  // Element 1 moves to 0.
    delete pa; // Delete the original element at 0.
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("RemoveAt example: ") << &arr << _T("\n");
#endif      

sistema autônomo resultados deste programa são da seguinte maneira:

RemoveAt example: A CObArray with 1 elements

[0] = a CAge at $4606 40

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe CObArray

Gráfico de hierarquia

CObArray::SetAt

CObArray::SetAtGrow

CObArray::InsertAt

Outros recursos

CObArray membros