Freigeben über


allocator_base-Klasse

Definiert die Basisklasse und allgemeine Funktionen, die zum Erstellen einer benutzerdefinierten Zuweisung von einem Synchronisierungsfilter erforderlich sind.

Syntax

template <class Type, class Sync>
class allocator_base

Parameter

Typ
Der Elementtyp, die durch die Zuweisung zugeordnet wird.

Sync
Die Synchronisierungsrichtlinie für die Zuweisung: sync_none-Klasse, sync_per_container-Klasse, sync_per_thread-Klasse oder sync_shared-Klasse.

Konstruktoren

Konstruktor Beschreibung
allocator_base Konstruiert ein Objekt vom Typ allocator_base.

TypeDefs

Typname Beschreibung
const_pointer Ein Typ, der einen konstanten Zeiger auf den Typ des Objekts bereitstellt, das von der Zuweisung verwaltet wird.
const_reference Ein Typ, der einen konstanten Verweis auf den Typ des Objekts bereitstellt, das von der Zuweisung verwaltet wird.
difference_type Ein ganzzahliger Typ mit Vorzeichen, der die Differenz zwischen Werten von Zeigern und dem Typ des Objekts, das von der Zuweisung verwaltet wird, darstellen kann.
pointer Ein Typ, der einen Zeiger auf den Typ des Objekts bereitstellt, das von der Zuweisung verwaltet wird.
reference Ein Typ, der einen Verweis auf den Typ des Objekts bereitstellt, das von der Zuweisung verwaltet wird.
size_type Ein nicht signierter Integraltyp, der die Länge einer beliebigen Sequenz darstellen kann, die ein Objekt vom Typ allocator_base zuordnen kann.
value_type Ein Typ, der von der Zuweisung verwaltet wird.

Memberfunktionen

Memberfunktion Beschreibung
_Charalloc Ordnet einem Array des Typs char Speicherplatz zu.
_Chardealloc Gibt für das Array mit Elementen vom Typ char Speicherplatz frei.
address Sucht die Adresse eines Objekts, dessen Wert angegeben wird.
allocate Ordnet einen Speicherblock zu, der groß genug ist, um mindestens eine angegebene Anzahl von Elementen zu speichern.
construct Erstellt eine bestimmte Art von Objekt an einer bestimmten Adresse, die mit einem angegebenen Wert initialisiert wird.
deallocate Gibt eine angegebene Anzahl von Objekten im Speicher frei, beginnend an einer angegebenen Position.
destroy Ruft einen Objektdestruktor auf, ohne die Zuordnung des Speicherplatzes aufzuheben, an dem Objekt gespeichert wurde.
max_size Gibt die Anzahl der Elemente vom Typ Type zurück, die von einem Objekt der Klassenzuweisung zugeordnet werden konnten, bevor der freie Speicherplatz verbraucht ist.

Anforderungen

Header:<allocators>

Namespace: stdext

allocator_base::_Charalloc

Ordnet einem Array des Typs char Speicherplatz zu.

char *_Charalloc(size_type count);

Parameter

count
Die Anzahl der zuzuweisenden Elemente im Array

Rückgabewert

Zeiger auf das zugewiesene Objekt.

Hinweise

Diese Memberfunktion wird von Containern verwendet, wenn sie mit einem Compiler kompiliert werden, der nicht kompiliert werden kann. Es implementiert _Charalloc für die benutzerdefinierte allocator-Klasse, indem es das Ergebnis eines Aufrufs an die Funktion allocate des Synchronisationsfilters zurückgibt.

allocator_base::_Chardealloc

Gibt für das Array mit Elementen vom Typ char Speicherplatz frei.

void _Chardealloc(void* ptr, size_type count);

Parameter

ptr
Ein Zeiger auf das erste Objekt, dessen Zuweisung zum Speicher aufgehoben werden soll.

count
Die Anzahl von Objekten, deren Zuweisung zum Speicherplatz aufgehoben werden soll.

Hinweise

Diese Memberfunktion wird von Containern verwendet, wenn sie mit einem Compiler kompiliert werden, der nicht kompiliert werden kann. Für die benutzerdefinierte allocator-Klasse implementiert es _Chardealloc, indem es das Ergebnis eines Aufrufs an die Funktion deallocate des Synchronisationsfilters zurückgibt. Der Zeiger ptr muss schon vorher für ein Zuweisungsobjekt, das gleich *this ist,von einen Aufruf an _Charalloc zurückgegeben worden sein, damit er ein Arrayobjekt der gleichen Größe und des gleichen Typs zuweisen kann. _Chardealloc löst nie eine Ausnahme aus.

allocator_base::address

Sucht die Adresse eines Objekts, dessen Wert angegeben wird.

pointer address(reference val);

const_pointer address(const_reference val);

Parameter

val
Der konstante oder nicht konstante Wert des Objekts, nach dessen Adresse gesucht wird.

Rückgabewert

Ein konstanter oder nicht konstanter Zeiger auf ein Objekt mit konstantem bzw. nicht konstantem Wert.

Hinweise

Diese Memberfunktion wird für die benutzerdefinierte allocator-Klasse implementiert, indem &val zurückgegeben wird.

allocator_base::zuweisung

Ordnet einen Speicherblock zu, der groß genug ist, um mindestens eine angegebene Anzahl von Elementen zu speichern.

template <class Other>
pointer allocate(size_type _Nx, const Other* _Hint = 0);

pointer allocate(size_type _Nx);

Parameter

_Nx
Die Anzahl der zuzuweisenden Elemente im Array

_Hint
Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

Rückgabewert

Zeiger auf das zugewiesene Objekt.

Hinweise

Die Memberfunktion implementiert Speicherreservierung für die benutzerdefinierte allocator-Klasse, indem sie das Ergebnis eines Aufrufs an die Funktion allocate des Synchronisationsfilters des Typs „type“ * wenn _Nx == 1 zurückgibt; andernfalls indem sie das Ergebnis eines Aufrufs an den Cast operator new(_Nx * sizeof(Type)) des Typs „Type“ *.

allocator_base::allocator_base

Konstruiert ein Objekt vom Typ allocator_base.

allocator_base();

template <class Other>
allocator_base(const allocator_base<Other, Sync>& right);

Parameter

right
Das zu kopierende Zuweisungsobjekt.

Hinweise

Der erste Konstruktor erstellt eine allocator_base-Instanz. Der zweite Konstruktor erstellt eine allocator_base-Instanz, so dass jede allocator_base<Type, _Sync>-Instanz a, allocator_base<Type, Sync>(allocator_base<Other, Sync>(a)) == a.

allocator_base::const_pointer

Ein Typ, der einen konstanten Zeiger auf den Typ des Objekts bereitstellt, das von der Zuweisung verwaltet wird.

typedef const Type *const_pointer;

allocator_base::const_reference

Ein Typ, der einen konstanten Verweis auf den Typ des Objekts bereitstellt, das von der Zuweisung verwaltet wird.

typedef const Type& const_reference;

allocator_base::construct

Erstellt eine bestimmte Art von Objekt an einer bestimmten Adresse, die mit einem angegebenen Wert initialisiert wird.

void construct(pointer ptr, const Type& val);

Parameter

ptr
Ein Zeiger auf den Speicherort, in dem das Objekt erstellt werden soll.

val
Der Wert, mit dem das zu erstellende Objekt initialisiert werden soll.

Hinweise

Diese Memberfunktion wird für die benutzerdefinierte allocator-Klasse implementiert, indem new((void*)ptr Type(val) aufgerufen wird.

allocator_base::d eallocate

Gibt eine angegebene Anzahl von Objekten im Speicher frei, beginnend an einer angegebenen Position.

void deallocate(pointer ptr, size_type _Nx);

Parameter

ptr
Ein Zeiger auf das erste Objekt, dessen Zuweisung zum Speicher aufgehoben werden soll.

_Nx
Die Anzahl von Objekten, deren Zuweisung zum Speicherplatz aufgehoben werden soll.

Hinweise

Die Memberfunktion wird für die benutzerdefinierte allocator-Klasse implementiert, indem deallocate(ptr) im Synchronisationsfilter Sync wenn _Nx == 1 aufgerufen wird; andernfalls Aufruf an operator delete(_Nx * ptr).

allocator_base::d estroy

Ruft einen Objektdestruktor auf, ohne die Zuordnung des Speicherplatzes aufzuheben, an dem Objekt gespeichert wurde.

void destroy(pointer ptr);

Parameter

ptr
Ein Zeiger, der die Adresse des zu zerstörenden Objekts angibt.

Hinweise

Diese Memberfunktion wird für die benutzerdefinierte allocator-Klasse implementiert, indem ptr->~Type() aufgerufen wird.

allocator_base::d ifference_type

Ein ganzzahliger Typ mit Vorzeichen, der die Differenz zwischen Werten von Zeigern und dem Typ des Objekts, das von der Zuweisung verwaltet wird, darstellen kann.

typedef std::ptrdiff_t difference_type;

allocator_base::max_size

Gibt die Anzahl der Elemente vom Typ Type zurück, die von einem Objekt der Klassenzuweisung zugeordnet werden konnten, bevor der freie Speicherplatz verbraucht ist.

size_type max_size() const;

Rückgabewert

Die Anzahl von Elementen, die zugewiesen werden konnten.

Hinweise

Diese Memberfunktion wird für die benutzerdefinierte allocator-Klasse implementiert, indem (size_t)-1 / sizeof(Type) wenn 0 < (size_t)-1 / sizeof(Type) zurückgegeben wird; andernfalls 1.

allocator_base::p ointer

Ein Typ, der einen Zeiger auf den Typ des Objekts bereitstellt, das von der Zuweisung verwaltet wird.

typedef Type *pointer;

allocator_base::reference

Ein Typ, der einen Verweis auf den Typ des Objekts bereitstellt, das von der Zuweisung verwaltet wird.

typedef Type& reference;

allocator_base::size_type

Ein nicht signierter Integraltyp, der die Länge einer beliebigen Sequenz darstellen kann, die ein Objekt vom Typ allocator_base zuordnen kann.

typedef std::size_t size_type;

allocator_base::value_type

Ein Typ, der von der Zuweisung verwaltet wird.

typedef Type value_type;

Siehe auch

<allocators>