Método CHStringArray::RemoveAt (chstrarr.h)

[A classe CHStringArray faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional será disponibilizada para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas para todos os novos desenvolvimentos.]

O método RemoveAt remove um ou mais elementos começando em um índice especificado em uma matriz.

Sintaxe

void RemoveAt(
  int nIndex,
  int nCount
);

Parâmetros

nIndex

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

nCount

O número de elementos a serem removidos. O padrão é 1 (um).

Retornar valor

Nenhum

Comentários

No processo de remoção de elementos, RemoveAt desloca todos os elementos localizados acima dos elementos que são removidos. Esse método diminui o limite superior da matriz, mas não libera memória.

Exemplos

O exemplo de código a seguir mostra o uso de CHStringArray::RemoveAt.

CHStringArray array;

array.Add( L"String 1" ); // Element 0
array.Add( L"String 2" ); // Element 1
array.RemoveAt( 0 );  // Element 1 moves to 0.
assert ( array[0] == L"String 2" );

Os resultados deste programa são os seguintes.

[0] = String 2

Requisitos

Confira também

CHStringArray

CHStringArray::Add

CHStringArray::GetAt

CHStringArray::InsertAt