CWordArray-Klasse

Unterstützt Arrays mit 16-Bit-Wörtern.

Syntax

class CWordArray : public CObject

Member

Die Memberfunktionen CWordArray ähneln den Memberfunktionen der Klasse CObArray. Aufgrund dieser Ähnlichkeit können Sie die CObArray-Referenzdokumentation für Memberfunktionsbesonderheiten verwenden. Überall dort, wo ein CObject-Zeiger als Funktionsparameter oder Rückgabewert angezeigt wird, ersetzen Sie ein WORD.

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

Beispielsweise übersetzt zu

WORD CWordArray::GetAt( int <nIndex> ) const;

Öffentliche Konstruktoren

Name	Beschreibung
CWordArray::CWordArray	Erstellt ein leeres Array.

Öffentliche Methoden

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

Öffentliche Operatoren

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

Hinweise

CWordArrayenthält das IMPLEMENT_SERIAL Makro zur Unterstützung der Serialisierung und des Dumpings seiner Elemente. Wenn ein Array von Wörtern in einem Archiv gespeichert wird, entweder mit einem überladenen Einfügeoperator oder mit der CObject::Serialize-Memberfunktion , wird jedes Element wiederum 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 ein Abbild einzelner Elemente im Array benötigen, müssen Sie die Tiefe des Dumpkontexts auf 1 oder höher festlegen.

Weitere Informationen zur Verwendung CWordArrayfinden Sie im Artikel Sammlungen.

Vererbungshierarchie

CObject

CWordArray

Anforderungen

Kopfzeile: afxcoll.h

Siehe auch

MFC Sample COLLECT
CObject-Klasse
Hierarchiediagramm