std::allocator_traits

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Speicherverwaltungsbibliothek

voidify (nur Exposition*) Algorithmen für uninitialisierten Speicher uninitialized_copy uninitialized_fill uninitialized_move (C++17) uninitialized_default_construct (C++17) uninitialized_value_construct (C++17) destroy (C++17) destroy_at (C++17) uninitialized_copy_n (C++11) uninitialized_fill_n uninitialized_move_n (C++17) uninitialized_default_construct_n (C++17) uninitialized_value_construct_n (C++17) destroy_n (C++17) construct_at (C++20) Beschränkte uninitialisierte Speicher-Algorithmen ranges::uninitialized_copy (C++20) ranges::uninitialized_fill (C++20) ranges::uninitialized_move (C++20) ranges::construct_at (C++20) ranges::destroy (C++20) ranges::destroy_n (C++20) ranges::destroy_at (C++20) ranges::uninitialized_copy_n (C++20) ranges::uninitialized_fill_n (C++20) ranges::uninitialized_move_n (C++20) ranges::uninitialized_default_construct (C++20) ranges::uninitialized_value_construct (C++20) ranges::uninitialized_default_construct_n (C++20)  ranges::uninitialized_value_construct_n (C++20) C-Bibliothek malloc calloc realloc aligned_alloc (C++17) free

Allocatoren allocator allocator_traits (C++11) allocation_result (C++23) allocator_arg (C++11) uses_allocator (C++11) uses_allocator_construction_args (C++20) make_obj_using_allocator (C++20) uninitialized_construct_using_allocator (C++20)  scoped_allocator_adaptor (C++11) pmr::polymorphic_allocator (C++17) Speicherressourcen pmr::memory_resource (C++17) pmr::get_default_resource (C++17) pmr::set_default_resource (C++17) pmr::new_delete_resource (C++17) pmr::null_memory_resource (C++17) pmr::synchronized_pool_resource (C++17) pmr::unsynchronized_pool_resource (C++17) pmr::monotonic_buffer_resource (C++17) pmr::pool_options (C++17) Unterstützung für Garbage Collection declare_reachable (C++11)(bis C++23) undeclare_reachable (C++11)(bis C++23) declare_no_pointers (C++11)(bis C++23) undeclare_no_pointers (C++11)(bis C++23) pointer_safety (C++11)(bis C++23) get_pointer_safety (C++11)(bis C++23) Uninitialisierter Speicher raw_storage_iterator (bis C++20*) get_temporary_buffer (bis C++20*) return_temporary_buffer (bis C++20*) Explizites Lebenszeitmanagement start_lifetime_asstart_lifetime_as_array (C++23)(C++23)

Smarte Zeiger unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (bis C++17*) owner_less (C++11) owner_less<void> (C++17) owner_hash (C++26) owner_equal (C++26) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) out_ptr_t (C++23) inout_ptr_t (C++23) Low-Level-Speicher verwaltung operator new operator new[] operator delete operator delete[] get_new_handler (C++11) set_new_handler launder (C++17) bad_alloc bad_array_new_length (C++11) nothrow_t align_val_t (C++17) destroying_delete_t (C++20) new_handler nothrow Sonstiges pointer_traits (C++11) to_address (C++20) addressof (C++11) align (C++11) assume_aligned (C++20) is_sufficiently_aligned (C++26)

 

std::allocator_traits

Membertypen

Memberfunktionen

allocator_traits::allocate

allocator_traits::allocate_at_least (C++23)

allocator_traits::deallocate

allocator_traits::construct

allocator_traits::destroy

allocator_traits::max_size

allocator_traits::select_on_container_copy_construction

 

Definiert in Header <memory>
template< class Alloc > struct allocator_traits;		(seit C++11)

Die Klasse allocator_traits stellt den standardisierten Weg dar, um auf verschiedene Eigenschaften von Allocatoren zuzugreifen. Die Standardcontainer und andere Standardbibliothekskomponenten greifen über diese Vorlage auf Allocatoren zu, was die Verwendung jedes Klassentyps als Allocator ermöglicht, solange die vom Benutzer bereitgestellte Spezialisierung von std::allocator_traits die gesamte erforderliche Funktionalität implementiert.

Ein Programm, das eine explizite oder partielle Spezialisierung von std::allocator_traits deklariert, ist nicht wohlgeformt, keine Diagnose erforderlich.

(seit C++23)

Die Standard-, nicht spezialisierte std::allocator_traits enthält die folgenden Member

Member Types

Typ	Definition
allocator_type	Alloc
value_type	Alloc::value_type
Zeiger	Alloc::pointer, falls vorhanden, andernfalls value_type*
const_pointer	Alloc::const_pointer, falls vorhanden, andernfalls std::pointer_traits<pointer>::rebind<const value_type>
void_pointer	Alloc::void_pointer, falls vorhanden, andernfalls std::pointer_traits<pointer>::rebind<void>
const_void_pointer	Alloc::const_void_pointer, falls vorhanden, andernfalls std::pointer_traits<pointer>::rebind<const void>
difference_type	Alloc::difference_type, falls vorhanden, andernfalls std::pointer_traits<pointer>::difference_type
size_type	Alloc::size_type, falls vorhanden, andernfalls std::make_unsigned<difference_type>::type
propagate_on_container_copy_assignment	Alloc::propagate_on_container_copy_assignment, falls vorhanden, andernfalls std::false_type
propagate_on_container_move_assignment	Alloc::propagate_on_container_move_assignment, falls vorhanden, andernfalls std::false_type
propagate_on_container_swap	Alloc::propagate_on_container_swap, falls vorhanden, andernfalls std::false_type
is_always_equal	Alloc::is_always_equal, falls vorhanden, andernfalls std::is_empty<Alloc>::type

Member Alias Templates

Typ	Definition
rebind_alloc<T>	Alloc::rebind<T>::other, falls vorhanden, andernfalls SomeAllocator<T, Args>, wenn dieser Alloc die Form SomeAllocator<U, Args> hat, wobei Args null oder mehr Typargumente sind
rebind_traits<T>	std::allocator_traits<rebind_alloc<T>>

Member Functions

allocate [static]	alloziiert uninitialisierten Speicher unter Verwendung des Allokators (public static member function)
allocate_at_least [static] (C++23)	allokiert Speicher, der mindestens so groß ist wie die angeforderte Größe über einen Allokator (public static member function)
deallocate [static]	dealloziert Speicher mit dem Allocator (public static member function)
construct [static]	konstruiert ein Objekt im allozierten Speicher (function template)
destroy [static]	destruiert ein Objekt im allozierten Speicher (function template)
max_size [static]	gibt die vom Allocator unterstützte maximale Objektgröße zurück (public static member function)
select_on_container_copy_construction [static]	ermittelt den Allocator, der nach dem Kopieren eines Standardcontainers verwendet werden soll (public static member function)

Defect Reports

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 2108	C++11	Es gab keine Möglichkeit zu zeigen, dass ein Allocator zustandslos ist	is_always_equal bereitgestellt

Siehe auch

AllocatorAwareContainer (C++11)	Container mit Allocator; Verwendung zugehöriger Traits (z.B. propagate_on_container_swap) (benannte Anforderung)
allocator	der Standard-Allocator (Klassen-Template)
scoped_allocator_adaptor (C++11)	implementiert mehrstufige Allokatoren für mehrstufige Container (Klassen-Template)
pointer_traits (C++11)	liefert Informationen über zeigerähnliche Typen (Klassen-Template)