std::experimental::pmr::polymorphic_allocator

 

C++

Language

Standard Library Headers

Freestanding and hosted implementations

Named requirements

Language support library

Concepts library (C++20)

Diagnostics library

Utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Filesystem library (C++17)

Technical Specifications

 

Library fundamentals

experimental::optional

experimental::any

experimental::basic_string_view

experimental::sample

experimental::shared_ptr

experimental::weak_ptr

experimental::apply

experimental::invocation_type experimental::raw_invocation_type

experimental::search

experimental::default_searcher experimental::make_default_searcher

experimental::boyer_moore_searcher experimental::make_boyer_moore_searcher

experimental::boyer_moore_horspool_searcher experimental::make_boyer_moore_horspool_searcher

type-erased and polymorphic allocators

variable templates for type traits

 

Polymorphic allocator library

polymorphic_allocator

convenience aliases for containers using polymorphic_allocator

Memory resource classes

memory_resource

synchronized_pool_resource

unsynchronized_pool_resource

monotonic_buffer_resource

resource_adaptor

Global memory resources

new_delete_resource

null_memory_resource

get_default_resource

set_default_resource

Type-erased allocator support for existing classes

function

packaged_task

promise

 

std::experimental::pmr::polymorphic_allocator

Member functions

polymorphic_allocator::polymorphic_allocator

polymorphic_allocator::operator=

polymorphic_allocator::allocate

polymorphic_allocator::deallocate

polymorphic_allocator::construct

polymorphic_allocator::destroy

polymorphic_allocator::select_on_container_copy_construction

polymorphic_allocator::resource

Non-member functions

operator==operator!=

 

Defined in header <experimental/memory_resource>
template< class T > class polymorphic_allocator;		(library fundamentals TS)

The class template std::experimental::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.

Member types

Member type	definition
value_type	T

Member functions

(constructor)	Constructs a polymorphic_allocator (public member function)
(destructor) (implicitly declared)	Implicitly declared destructor (public member function)
operator=	Copy assignment operator (public member function)
Public member functions
allocate	Allocate memory (public member function)
deallocate	Deallocate memory (public member function)
construct	Constructs an object in allocated storage (public member function)
destroy	Destroys an object in allocated storage (public member function)
select_on_container_copy_construction	Create a new polymorphic_allocator for use by a container's copy constructor (public member function)
resource	Returns a pointer to the underlying memory resource (public member function)

Non-member functions

operator==operator!=

compare two polymorphic_allocators (function)