CHStringArray::Add-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 Add-Methode fügt am Ende eines Arrays ein neues Element hinzu und erhöht das Array um eins.

Syntax

int  throw(CHeap_Exception) Add(
  LPCWSTR newElement
);

Parameter

newElement

Das Element, das dem Array hinzugefügt werden soll.

Rückgabewert

Wenn die Add-Methode erfolgreich ist, gibt sie den Index des hinzugefügten Elements zurück.

Hinweise

Wenn SetSize mit einem nGrowBy-Wert größer als 1 verwendet wurde, kann zusätzlicher Arbeitsspeicher zugewiesen werden. Die Obergrenze erhöht sich jedoch nur um eins.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung von Add.

    CHStringArray array;
    CHString s( L"String 2");
    
    array.Add( L"String 1" ); // Element 0
    array.Add( s );           // Element 1

Anforderungen

Weitere Informationen

CHStringArray

CHStringArray::Append

CHStringArray::Copy