CObArray::RemoveAt

privatevoid RemoveAt ( int nIndex, int nCount = 1 );

Parâmetros

nIndex

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

nCount

O número de elementos para remover.

Observações

Remove um ou mais elementos começando um índice especificado em uma matriz. No processo, ele alterna para baixo todos os elementos acima o elemento removido (s). Ele diminui a parte superior ligado da matriz mas não livre memória.

Se você tentar remover mais elementos que estão contidos na matriz acima do ponto de remoção, então a versão de Depurar da biblioteca asserts.

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

A tabela a seguir mostra Outro funções de membro que são semelhantes às CObArray::RemoveAt.

Classe Função de membro
CByteArray void RemoveAt (int nIndex, int nCount = 1);
CDWordArray void RemoveAt (int nIndex, int nCount = 1);
CPtrArray void RemoveAt (int nIndex, int nCount = 1);
CStringArray void RemoveAt (int nIndex, int nCount = 1);
CUIntArray void RemoveAt (int nIndex, int nCount = 1);
CWordArray void RemoveAt (int nIndex, int nCount = 1);

Exemplo

Consulte CObList:: CObList para obter uma listagem do CAge classe usada em tudo exemplos coleção.

/ / exemplo de CObArray::RemoveAt

nbsp; CObArray matriz;
   CObject * pa;

matriz.Adicionar (nova gaiola (21)); / / Elemento 0
   matriz.Adicionar (nova gaiola (40)); / / Elemento 1
   se ((pa = array.GetAt (0))! = NULL)
   {
       matriz.RemoveAt (0);  / / Elemento 1 move para 0.
       Excluir pa; / / Excluir o elemento original em 0.
   }
# ifdef  Debug
   afxDump.SetDepth (1);
   afxDump << "exemplo de RemoveAt:" << & matriz << "\n";
# endif

Os resultados deste programa são os seguintes:

Exemplo de RemoveAt: um CObArray com eleme&ntos 1
 nbsp;  [0] = uma gaiola em $4606 40

Visão geral de CObArrayMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CObArray:: SetAt, CObArray::SetAtGrow, CObArray:: InsertAt

Index