CHStringArray::RemoveAt-Methode (chstrarr.h)
[Die Klasse CHStringArray ist Teil des WMI-Anbieterframeworks, das nun als endgültig betrachtet wird, und es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]
Die RemoveAt-Methode entfernt ein oder mehrere Elemente, die bei einem angegebenen Index in einem Array beginnen.
Syntax
void RemoveAt(
int nIndex,
int nCount
);
Parameter
nIndex
Ein ganzzahliger Index, der größer oder gleich null und kleiner als oder gleich dem von GetUpperBound zurückgegebenen Wert ist.
nCount
Die Anzahl der zu entfernenden Elemente. Der Standardwert ist 1 (1).
Rückgabewert
Keine
Bemerkungen
Beim Entfernen von Elementen verschiebt RemoveAt alle Elemente, die sich über den entfernten Elementen befinden. Diese Methode dekrementiert die Obergrenze des Arrays, gibt jedoch keinen Arbeitsspeicher frei.
Beispiele
Im folgenden Codebeispiel wird die Verwendung von CHStringArray::RemoveAt veranschaulicht.
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" );
Die Ergebnisse dieses Programms sind wie folgt:
[0] = String 2
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | chstrarr.h (einschließlich FwCommon.h) |
| Bibliothek | FrameDyn.lib |
| DLL | FrameDynOS.dll; FrameDyn.dll |