std::pmr::polymorphic_allocator

 

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::pmr::polymorphic_allocator

Memberfunktionen

polymorphic_allocator::polymorphic_allocator

polymorphic_allocator::allocate

polymorphic_allocator::deallocate

polymorphic_allocator::construct

polymorphic_allocator::destroy (C++20/26*)

polymorphic_allocator::allocate_bytes (C++20)

polymorphic_allocator::deallocate_bytes (C++20)

polymorphic_allocator::allocate_object (C++20)

polymorphic_allocator::deallocate_object (C++20)

polymorphic_allocator::new_object (C++20)

polymorphic_allocator::delete_object (C++20)

polymorphic_allocator::select_on_container_copy_construction

polymorphic_allocator::resource

Nicht-Member-Funktionen

operator==operator!= (bis C++20)

 

Definiert in Header <memory_resource>
template< class T > class polymorphic_allocator;		(seit C++17) (bis C++20)
template< class T = std::byte > class polymorphic_allocator;		(seit C++20)

Die Klassenschablone std::pmr::polymorphic_allocator ist ein Allocator, der ein unterschiedliches Allokationsverhalten zeigt, abhängig von der std::pmr::memory_resource, aus der er konstruiert wird. Da memory_resource Laufzeitpolymorphie zur Verwaltung von Allokationen verwendet, sind verschiedene Container-Instanzen mit polymorphic_allocator als statischem Allokator-Typ interoperabel, können sich aber so verhalten, als hätten sie unterschiedliche Allokator-Typen.

Alle Spezialisierungen von polymorphic_allocator erfüllen die Anforderungen an die Vollständigkeit von Allocators.

Die Member-Funktion polymorphic_allocator::construct führt Uses-Allocator-Konstruktion durch, sodass die Elemente eines Containers, der einen polymorphic_allocator verwendet, denselben Allokator für ihre eigenen Allokationen verwenden. Beispielsweise verwendet ein std::pmr::vector<std::pmr::string> denselben memory_resource sowohl für den Speicher des vector als auch für den Speicher jedes string.

Für nicht-polymorphe Allocators kann eine ähnliche Weitergabe mit Hilfe von std::scoped_allocator_adaptor erreicht werden.

Member-Typen

Mitgliedertyp	Definition
value_type	T

Member-Funktionen

(Konstruktor)	konstruiert einen polymorphic_allocator (public member function)
(Destruktor) (implizit deklariert)	implizit deklarierter Destruktor (public member function)
operator= [gelöscht]	Kopierzuweisungsoperator ist gelöscht (public member function)
Öffentliche Memberfunktionen
allocate	alloziiert Speicher (public member function)
deallocate	deallokiert Speicher (public member function)
construct	konstruiert ein Objekt im allokierten Speicher (public member function)
destroy (in C++20 veraltet)(in C++26 wieder eingeführt)	zerstört ein Objekt im allokierten Speicher (public member function)
allocate_bytes (C++20)	allokiert rohen, ausgerichteten Speicher aus der zugrundeliegenden Ressource (public member function)
deallocate_bytes (C++20)	gibt rohen Speicher frei, der von allocate_bytes bezogen wurde (public member function)
allocate_object (C++20)	allokiert rohen Speicher, der für ein Objekt oder ein Array geeignet ist (public member function)
deallocate_object (C++20)	gibt rohen Speicher frei, der von allocate_object bezogen wurde (public member function)
new_object (C++20)	allokiert und konstruiert ein Objekt (public member function)
delete_object (C++20)	zerstört und deallokiert ein Objekt (public member function)
select_on_container_copy_construction	erstellt einen neuen polymorphic_allocator zur Verwendung durch den Kopierkonstruktor eines Containers (public member function)
resource	gibt einen Zeiger auf die zugrundeliegende Speicherressource zurück (public member function)

Nicht-Member-Funktionen

operator==operator!= (in C++20 entfernt)

vergleicht zwei polymorphic_allocator (function)

Anmerkungen

polymorphic_allocator propagiert nicht bei Container-Kopierzuweisung, Verschiebezuweisung oder Swap. Infolgedessen kann die Verschiebezuweisung eines polymorphic_allocator-verwendenden Containers eine Ausnahme auslösen, und das Tauschen von zwei polymorphic_allocator-verwendenden Containern, deren Allocators sich nicht vergleichen lassen, führt zu undefiniertem Verhalten.

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_polymorphic_allocator	201902L	(C++20)	std::pmr::polymorphic_allocator<> als Vokabulartyp

Siehe auch

memory_resource (C++17)

eine abstrakte Schnittstelle für Klassen, die Speicherressourcen kapseln (Klasse)