CPtrArray-Klasse
Unterstützt Arrays mit void-Zeigern.
Syntax
class CPtrArray : public CObject
Member
Die Memberfunktionen CPtrArray ähneln den Memberfunktionen der Klasse CObArray. Aufgrund dieser Ähnlichkeit können Sie die CObArray-Referenzdokumentation für Memberfunktionsbesonderheiten verwenden. Wenn ein Zeiger als Funktionsparameter oder Rückgabewert angezeigt CObject wird, ersetzen Sie einen Zeiger auf void.
CObject* CObArray::GetAt( int <nIndex> ) const;
Beispielsweise übersetzt zu
void* CPtrArray::GetAt( int <nIndex> ) const;
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CPtrArray::CPtrArray | Erstellt ein leeres Array. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CPtrArray::Add | Fügt am Ende des Arrays ein Element hinzu; vergrößert das Array bei Bedarf. |
| CPtrArray::Append | Hängt ein anderes Array an das Array an; vergrößert das Array bei Bedarf. |
| CPtrArray::Copy | Kopiert ein anderes Array in das Array; vergrößert das Array bei Bedarf. |
| CPtrArray::ElementAt | Gibt einen temporären Verweis auf den Elementzeiger innerhalb des Arrays zurück. |
| CPtrArray::FreeExtra | Gibt den gesamten nicht verwendeten Arbeitsspeicher über der aktuellen Obergrenze frei. |
| CPtrArray::GetAt | Gibt den Wert an einem bestimmten Index zurück. |
| CPtrArray::GetCount | Ruft die Anzahl der Elemente im Array ab. |
| CPtrArray::GetData | Ermöglicht den Zugriff auf Elemente im Array. Kann NULL sein. |
| CPtrArray::GetSize | Ruft die Anzahl der Elemente im Array ab. |
| CPtrArray::GetUpperBound | Gibt den größten gültigen Index zurück. |
| CPtrArray::InsertAt | Fügt ein Element (oder alle Elemente in einem anderen Array) am angegebenen Index ein. |
| CPtrArray::IsEmpty | Bestimmt, ob das Array leer ist. |
| CPtrArray::RemoveAll | Entfernt alle Elemente aus diesem Array. |
| CPtrArray::RemoveAt | Entfernt ein Element an einem spezifischen Index. |
| CPtrArray::SetAt | Legt den Wert für einen bestimmten Index fest; Array darf nicht vergrößert werden. |
| CPtrArray::SetAtGrow | Legt den Wert für einen bestimmten Index fest; vergrößert das Array bei Bedarf. |
| CPtrArray::SetSize | Legt die Anzahl der Elemente im Array fest. |
Öffentliche Operatoren
| Name | Beschreibung |
|---|---|
| CPtrArray::operator [ ] | Legt das Element am angegebenen Index fest oder ruft es ab. |
Hinweise
CPtrArray enthält das IMPLEMENT_DYNAMIC Makro zur Unterstützung des Laufzeittypzugriffs und des Dumpings für ein CDumpContext Objekt. Wenn Sie ein Dump einzelner Zeigerarrayelemente benötigen, müssen Sie die Tiefe des Dumpkontexts auf 1 oder höher festlegen.
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.
Zeigerarrays können nicht serialisiert werden.
Wenn ein Zeigerarray gelöscht wird oder dessen Elemente entfernt werden, werden nur die Zeiger entfernt, nicht die Entitäten, auf die sie verweisen.
Weitere Informationen zur Verwendung CPtrArrayfinden Sie im Artikel Sammlungen.
Vererbungshierarchie
CPtrArray
Anforderungen
Kopfzeile: afxcoll.h