CObArray-Klasse

Artikel
02/26/2013

Unterstützt Arrays CObject Zeiger.

class CObArray : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Description
CObArray::CObArray	Erstellt ein leeres Array für CObject Zeiger.

Ö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

Diese Objektarrays sind zu C-Arrays ähnlich, allerdings können dynamisch verkleinern und bei Bedarf wachsen.

Anfang der Arrayindizes immer an Position 0.Sie können entscheiden, ob die Obergrenze korrigiert oder dem Array ermöglicht, zu erweitern, wenn Sie Elemente hinter der Stromgrenze hinzufügen.Arbeitsspeicher wird nacheinander zur Obergrenze zugeordnet, selbst wenn einige Elemente NULL sind.

Die Win32 wird die Größe eines Objekts CObArray nur an den verfügbaren Arbeitsspeicher begrenzt.

Wie bei Wechselstrom-Array, ist die Zugriffsgeschwindigkeit für ein CObArray indiziertes Element konstant und ist unabhängig von der Arraygröße.

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

Wenn Sie ein Speicherabbild der einzelnen CObject-Elemente in einem Array benötigen, müssen Sie die Tiefe des CDumpContext-Objekts auf 1 festlegen oder größer ist.

Wenn ein CObArray-Objekt gelöscht oder wenn seine Elemente entfernt werden, nur die CObject Zeiger entfernt werden, nicht die Objekte, die darauf verweisen.

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.

Arrayklassenableitung ist zur Listenableitung ähnlich.Ausführliche Informationen über die Ableitung einer Listenklasse für spezielle Zwecke, finden Sie im Artikel Auflistungen.

Hinweis
Sie müssen das IMPLEMENT_SERIAL-Makro in der Implementierung der abgeleiteten Klasse verwenden, wenn Sie beabsichtigen, das Array zu serialisieren.