Metodo CHStringArray::RemoveAt (chstrarr.h)

Articolo
02/23/2024

[La classe CHStringArray fa parte di WMI Provider Framework che è ora considerata nello stato finale e non saranno disponibili ulteriori sviluppi, miglioramenti o aggiornamenti per problemi non correlati alla sicurezza che interessano queste librerie. Le API MI devono essere usate per tutti i nuovi sviluppi.

Il metodo RemoveAt rimuove uno o più elementi a partire da un indice specificato in una matrice.

Sintassi

void RemoveAt(
  int nIndex,
  int nCount
);

Parametri

nIndex

Indice integer maggiore o uguale a zero e minore o uguale al valore restituito da GetUpperBound.

nCount

Numero di elementi da rimuovere. Il valore predefinito è 1 (uno).

Valore restituito

nessuno

Osservazioni

Nel processo di rimozione degli elementi, RemoveAt sposta tutti gli elementi che si trovano sopra gli elementi rimossi. Questo metodo decrementa il limite superiore della matrice, ma non libera memoria.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di 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" );

I risultati di questo programma sono i seguenti.

[0] = String 2

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	chstrarr.h (include FwCommon.h)
Libreria	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll