CStringArray-Klasse

Artikel
02/26/2013

Unterstützt Arrays CString-Objekte.

class CStringArray : public CObject

Mitglieder

Die Memberfunktionen von CStringArray sind - Memberfunktion der Klasse CObArray ähnlich.Aufgrund dieser Ähnlichkeit, können Sie die CObArray Referenzdokumentation für Memberfunktionsbesonderen verwenden.Wenn Sie einen CObject Zeiger als Rückgabewert finden, ersetzen Sie CString (keinen CString Zeiger).Wenn Sie einen CObject Zeiger als Funktionsparameter finden, ersetzen Sie LPCTSTR.

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

beispielsweise übersetzt zu

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

und

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

übersetzt zu

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

Öffentliche Konstruktoren

Name	Description
CObArray::CObArray	Erstellt ein leeres Array.

Öffentliche Methoden

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

Öffentliche Operatoren

Name	Description
CObArray::operator [ ]	Legt fest oder ruft das Element am angegebenen Index ab.

Hinweise

CStringArray enthält das IMPLEMENT_SERIAL-Makro, um die Serialisierung und das Speichern seiner Elemente zu unterstützen.Wenn ein Array CString-Objekte einem Archiv, entweder mit einem überladenen Einfügungsoperator oder mit der Serialize-Memberfunktion gespeichert wird, wird jedes Element wiederum serialisiert.

Hinweis
Vor der Verwendung eines Arrays, verwenden Sie SetSize, um die Größe und für sie Speicher reserviert.Wenn Sie nicht SetSize verwenden, wird das Hinzufügen von Elementen zu dem Array es, mehrfach neu zugeordnet werden und kopiert werden.Allgemeine Neuzuordnung und das Kopieren sind ineffizient und können Arbeitsspeicher fragmentieren.

Wenn Sie eine Dumpdatei einzelner Zeichenfolgenelementen im Array benötigen, müssen Sie die Tiefe des Dumpkontexts auf 1 festlegen oder größer ist.

Wenn ein CString Array gelöscht oder wenn seine Elemente entfernt werden, wird Zeichenfolgenarbeitsspeicher nach Bedarf freigegeben.

Weitere Informationen zur Verwendung von CStringArray, finden Sie im Artikel Auflistungen.

Vererbungshierarchie

CObject

CStringArray

Anforderungen

Header: afxcoll.h

Siehe auch

Referenz

CObject-Klasse

Hierarchien-Diagramm

Freigeben über