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

Artículo
08/22/2023

[La clase CHStringArray forma parte del marco del proveedor de WMI que ahora se considera en estado final y no habrá más desarrollo, mejoras o actualizaciones disponibles para problemas no relacionados con la seguridad que afecten a estas bibliotecas. Las API de MI se deben usar para todo el nuevo desarrollo.]

El método RemoveAt quita uno o varios elementos a partir de un índice especificado en una matriz.

Sintaxis

void RemoveAt(
  int nIndex,
  int nCount
);

Parámetros

nIndex

Índice entero mayor o igual que cero y menor o igual que el valor devuelto por GetUpperBound.

nCount

Número de elementos que se va a quitar. El valor predeterminado es 1 (uno).

Valor devuelto

None

Observaciones

En el proceso de quitar elementos, RemoveAt desplaza todos los elementos ubicados encima de los elementos que se quitan. Este método disminuye el límite superior de la matriz, pero no libera memoria.

Ejemplos

En el ejemplo de código siguiente se muestra el 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" );

Los resultados de este programa son los siguientes.

[0] = String 2

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	chstrarr.h (include FwCommon.h)
Library	FrameDyn.lib
Archivo DLL	FrameDynOS.dll; FrameDyn.dll