allocator_traits-Klasse

Die Klassenvorlage beschreibt ein Objekt, das einen Allocatortyp ergänzt. Ein Allocatortyp ist jeder Typ, der ein Zuweisungsobjekt beschreibt, das zum Verwalten von zugewiesenem Speicherplatz verwendet wird. Sie können insbesondere für jeden Allocator des Typs Allocallocator_traits<Alloc> verwenden, um alle Informationen zu erhalten, die für einen zuweisungsfähigen Container erforderlich sind. Weitere Informationen finden Sie unter der Standard-Allocator-Klasse.

Syntax

template <class Alloc>
    class allocator_traits;

Member

TypeDefs

Name	Beschreibung
allocator_type	Dieser Typ stellt ein Synonym für den Vorlagenparameter Allocdar.
const_pointer	Dieser Typ ist Alloc::const_pointer, wenn dieser Typ wohlgeformt ist; andernfalls ist dieser Typ pointer_traits<pointer>::rebind<const value_type>.
const_void_pointer	Dieser Typ ist Alloc::const_void_pointer, wenn dieser Typ wohlgeformt ist; andernfalls ist dieser Typ pointer_traits<pointer>::rebind<const void>.
difference_type	Dieser Typ ist Alloc::difference_type, wenn dieser Typ wohlgeformt ist; andernfalls ist dieser Typ pointer_traits<pointer>::difference_type.
pointer	Dieser Typ ist Alloc::pointer, wenn dieser Typ wohlgeformt ist; andernfalls ist dieser Typ value_type *.
propagate_on_container_copy_assignment	Dieser Typ ist Alloc::propagate_on_container_copy_assignment, wenn dieser Typ wohlgeformt ist; andernfalls ist dieser Typ false_type.
propagate_on_container_move_assignment	Dieser Typ ist Alloc::propagate_on_container_move_assignment, wenn dieser Typ wohlgeformt ist; andernfalls ist dieser Typ false_type. Wenn der Typ weiter gilt, kopiert ein zuweisungsfähiger Container seinen gespeicherten Allocator auf eine Bewegungszuweisung.
propagate_on_container_swap	Dieser Typ ist Alloc::propagate_on_container_swap, wenn dieser Typ wohlgeformt ist; andernfalls ist dieser Typ false_type. Wenn der Typ weiter gilt, tauscht ein zuweisungsfähiger Container seinen gespeicherten Allocator auf einem Swap aus.
size_type	Dieser Typ ist Alloc::size_type, wenn dieser Typ wohlgeformt ist; andernfalls ist dieser Typ make_unsigned<difference_type>::type.
value_type	Dieser Typ ist ein Synonym für Alloc::value_type.
void_pointer	Dieser Typ ist Alloc::void_pointer, wenn dieser Typ wohlgeformt ist; andernfalls ist dieser Typ pointer_traits<pointer>::rebind<void>.

Statische Methoden

Folgende statische Methoden rufen die entsprechenden Methoden auf einem vorhandenen Allocator-Parameter auf.

Name	Beschreibung
allocate	Eine statische Methode, die mithilfe des vorhandenen Allocator-Parameters Arbeitsspeicher zuweist.
construct	Eine statische Methode, die mithilfe eines angegebenen Allocators ein Objekt erstellt.
deallocate	Eine statische Methode, die mithilfe eines angegebenen Allocators eine angegebene Anzahl von Objekten freigibt.
destroy	Eine statische Methode, die mithilfe eines angegebenen Allocators den Destruktor in einem Objekt aufruft, ohne dass dessen Arbeitsspeicher freigegeben wird.
max_size	Eine statische Methode, die mithilfe eines angegebenen Allocators die maximale Anzahl von zuweisbaren Objekten ermittelt.
select_on_container_copy_construction	Eine statische Methode, die select_on_container_copy_construction in einem angegebenen Allocator aufruft.

allocate

Eine statische Methode, die mithilfe des vorhandenen Allocator-Parameters Arbeitsspeicher zuweist.

static pointer allocate(Alloc& al, size_type count);

static pointer allocate(Alloc& al, size_type count,
    typename allocator_traits<void>::const_pointer* hint);

Parameter

al
Ein Zuweisungsobjekt.

count
Die Anzahl der zuzuweisenden Elemente.

Hinweis
Ein const_pointer, der dem Zuweisungsobjekt möglicherweise dabei hilft, die Anforderung von Speicherplatz zu erfüllen. Dazu sucht er die Adresse eines vor der Anforderung zugewiesenen Objekts. Ein NULL-Zeiger wird nicht als Hinweis behandelt.

Rückgabewert

Jede Methode gibt einen Zeiger auf das zugewiesene Objekt zurück.

Die erste statische Methode gibt al.allocate(count) zurück.

Die zweite Methode gibt dann al.allocate(count, hint) zurück, wenn der Ausdruck wohlgeformt ist; andernfalls al.allocate(count).

Konstrukt

Eine statische Methode, die mithilfe eines angegebenen Allocators ein Objekt erstellt.

template <class Uty, class Types>
static void construct(Alloc& al, Uty* ptr, Types&&... args);

Parameter

al
Ein Zuweisungsobjekt.

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

args
Eine Liste von Argumenten, die an den Objektkonstruktor übergeben wird.

Hinweise

Die statische Memberfunktion ruft al.construct(ptr, args...) auf, wenn der Ausdruck wohlgeformt ist; andernfalls wertet es ::new (static_cast<void *>(ptr)) Uty(std::forward<Types>(args)...) aus.

deallocate

Eine statische Methode, die mithilfe eines angegebenen Allocators eine angegebene Anzahl von Objekten freigibt.

static void deallocate(Alloc al,
    pointer ptr,
    size_type count);

Parameter

al
Ein Zuweisungsobjekt.

ptr
Ein Zeiger auf den Anfangsort des Objekts, dessen Zuweisung aufzuheben ist.

count
Die Anzahl der freizugebenden Objekte.

Hinweise

Diese Methode ruft al.deallocate(ptr, count) auf.

Diese Methode löst keine Aktion aus.

destroy

Eine statische Methode, die mithilfe eines angegebenen Allocators den Destruktor in einem Objekt aufruft, ohne dass dessen Arbeitsspeicher freigegeben wird.

template <class Uty>
    static void destroy(Alloc& al, Uty* ptr);

Parameter

al
Ein Zuweisungsobjekt.

ptr
Ein Zeiger auf den Speicherort des Objekts.

Hinweise

Diese Methode ruft al.destroy(ptr) auf, wenn der Ausdruck wohlgeformt ist; andernfalls wertet es ptr->~Uty() aus.

max_size

Eine statische Methode, die mithilfe eines angegebenen Allocators die maximale Anzahl von zuweisbaren Objekten ermittelt.

static size_type max_size(const Alloc& al);

Parameter

al
Ein Zuweisungsobjekt.

Hinweise

Diese Methode gibt dann al.max_size() zurück, wenn der Ausdruck wohlgeformt ist; andernfalls numeric_limits<size_type>::max().

select_on_container_copy_construction

Eine statische Methode, die select_on_container_copy_construction in einem angegebenen Allocator aufruft.

static Alloc select_on_container_copy_construction(const Alloc& al);

Parameter

al
Ein Zuweisungsobjekt.

Rückgabewert

Diese Methode gibt al.select_on_container_copy_construction()zurück, wenn dieser Typ wohlgeformt ist; andernfalls wird al zurückgegeben.

Hinweise

Diese Methode wird verwendet, um einen Allocator anzugeben, wenn der zugeordnete Container durch eine Kopie erstellt wurde.