CStringArray-Klasse

Unterstützt Arrays mit CString -Objekten.

Syntax

class CStringArray : public CObject

Member

Die Memberfunktionen der CStringArray Klasse ähneln den Memberfunktionen der Klasse CObArray. Aufgrund dieser Ähnlichkeit können Sie die CObArray-Referenzdokumentation für Memberfunktionsbesonderheiten verwenden. Wenn ein Zeiger als Rückgabewert angezeigt CObject wird, ersetzen Sie ein CString Objekt (kein CString Zeiger). Immer dort, wo ein CObject-Zeiger als Funktionsparameter angezeigt wird, ersetzen Sie einen LPCTSTR.

CObject* CObArray::GetAt( int <nIndex> ) const;

Beispielsweise übersetzt zu

const CString& CStringArray::GetAt( int <nIndex> ) const;

and

void SetAt( int <nIndex>, CObject* <newElement> )

wird übersetzt in

void SetAt( int <nIndex>, LPCTSTR <newElement> )

Öffentliche Konstruktoren

Name Beschreibung
CStringArray::CStringArray Erstellt ein leeres Array.

Öffentliche Methoden

Name Beschreibung
CStringArray::Add Fügt am Ende des Arrays ein Element hinzu; vergrößert das Array bei Bedarf.
CStringArray::Append Hängt ein anderes Array an das Array an; vergrößert das Array bei Bedarf.
CStringArray::Copy Kopiert ein anderes Array in das Array; vergrößert das Array bei Bedarf.
CStringArray::ElementAt Gibt einen temporären Verweis auf den Elementzeiger innerhalb des Arrays zurück.
CStringArray::FreeExtra Gibt den gesamten nicht verwendeten Arbeitsspeicher über der aktuellen Obergrenze frei.
CStringArray::GetAt Gibt den Wert an einem bestimmten Index zurück.
CStringArray::GetCount Ruft die Anzahl der Elemente im Array ab.
CStringArray::GetData Ermöglicht den Zugriff auf Elemente im Array. Kann NULL sein.
CStringArray::GetSize Ruft die Anzahl der Elemente im Array ab.
CStringArray::GetUpperBound Gibt den größten gültigen Index zurück.
CStringArray::InsertAt Fügt ein Element (oder alle Elemente in einem anderen Array) am angegebenen Index ein.
CStringArray::IsEmpty Bestimmt, ob das Array leer ist.
CStringArray::RemoveAll Entfernt alle Elemente aus diesem Array.
CStringArray::RemoveAt Entfernt ein Element an einem spezifischen Index.
CStringArray::SetAt Legt den Wert für einen bestimmten Index fest; Array darf nicht vergrößert werden.
CStringArray::SetAtGrow Legt den Wert für einen bestimmten Index fest; vergrößert das Array bei Bedarf.
CStringArray::SetSize Legt die Anzahl der Elemente im Array fest.

Öffentliche Operatoren

Name Beschreibung
CStringArray::operator [ ] Legt das Element am angegebenen Index fest oder ruft es ab.

Hinweise

CStringArray enthält das Makro zur Unterstützung der IMPLEMENT_SERIAL Serialisierung und des Dumpings seiner Elemente. Wenn ein Array mit CString-Objekten in einem Archiv gespeichert wird, entweder mit einem überladenen Operator zum Einfügen oder mit der Serialize-Member-Funktion, wird jedes Element der Reihe nach serialisiert.

Hinweis

Vor dem Verwenden eines Arrays, verwenden Sie SetSize, um dessen Größe festzustellen, und weisen dafür Arbeitsspeicher zu. Wenn Sie SetSize nicht verwenden, kann das Hinzufügen von Elementen zu Ihrem Array dazu führen, dass es häufig neu zugeordnet und kopiert wird. Häufige Neuzuordnungen und Kopiervorgänge sind ineffizient und können zu einer Fragmentierung des Arbeitsspeichers führen.

Wenn Sie eine Sicherung einzelner Zeichenfolgenelemente im Array benötigen, müssen Sie die Tiefe des Sicherungskontexts auf 1 oder größer festlegen.

Wenn ein CString-Array gelöscht wird oder wenn dessen Elemente entfernt werden, wird je nach Bedarf Zeichenfolgenspeicher freigegeben.

Weitere Informationen zur Verwendung CStringArrayfinden Sie im Artikel Sammlungen.

Vererbungshierarchie

CObject

CStringArray

Anforderungen

Header: afxcoll.h

Siehe auch

CObject-Klasse
Hierarchiediagramm