stdpmrpolymorphic_allocator(3)
std::pmr::polymorphic_allocator - std::pmr::polymorphic_allocator
Synopsis
template< class T > (since C++17)
class polymorphic_allocator; (until C++20)
template< class T = std::byte > (since C++20)
class polymorphic_allocator;The class template std::pmr::polymorphic_allocator is an Allocator whose allocation behavior depends on the memory resource it is constructed with. Thus, different instances of polymorphic_allocator can exhibit entirely different allocation behavior. This runtime polymorphism allows objects using polymorphic_allocator to behave as if they used different allocator types at run time despite the identical static allocator type. All specializations of polymorphic_allocator meet the Allocator_completeness_requirements.
Member types
Member type definition value_type T
Member functions
destructor Implicitly declared destructor
operator= Copy assignment operator is deleted
Public member functions
allocate_bytes Allocate raw aligned memory from the underlying resource
deallocate_bytes Free raw memory obtained from allocate_bytes
allocate_object Allocates raw memory suitable for an object or an array
deallocate_object Frees raw memory obtained by allocate_object
new_object Allocates and constructs an object
delete_object Destroys and deallocates an object
Non-member functions
Notes
polymorphic_allocator does not propagate on container copy assignment, move assignment, or swap. As a result, move assignment of a polymorphic_allocator-using container can throw, and swapping two polymorphic_allocator-using containers whose allocators do not compare equal results in undefined behavior.
See also
memory_resource an abstract interface for classes that encapsulate memory resources