std::experimental::pmr::synchronized_pool_resource

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators 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::synchronized_pool_resource

synchronized_pool_resource::synchronized_pool_resource

synchronized_pool_resource::~synchronized_pool_resource

Public member functions

synchronized_pool_resource::release

synchronized_pool_resource::upstream_resource

synchronized_pool_resource::options

Protected member functions

synchronized_pool_resource::do_allocate

synchronized_pool_resource::do_deallocate

synchronized_pool_resource::do_is_equal

 

Defined in header <experimental/memory_resource>
class synchronized_pool_resource : public memory_resource;		(library fundamentals TS)

The class std::experimental::pmr::synchronized_pool_resource is a general-purpose memory resource class with the following properties:

• It owns the allocated memory and frees it on destruction, even if deallocate has not been called for some of the allocated blocks.
• It consists of a collection of pools that serves request for different block sizes. Each pool manages a collection of chunks that are then divided into blocks of uniform size.
• Calls to do_allocate are dispatched to the pool serving the smallest blocks accommodating the requested size.
• Exhausting memory in the pool causes the next allocation request for that pool to allocate an additional chunk of memory from the upstream allocator to replenish the pool. The chunk size obtained increases geometrically.
• Allocations requests that exceed the largest block size are served from the upstream allocator directly.
• The largest block size and maximum chunk size may be tuned by passing a std::experimental::pmr::pool_options struct to its constructor.

synchronized_pool_resource may be accessed from multiple threads without external synchronization, and may have thread-specific pools to reduce synchronization costs. If the memory resource is only accessed from one thread, unsynchronized_pool_resource is more efficient.

Member functions

(constructor)	Constructs a synchronized_pool_resource (public member function)
(destructor) [virtual]	Destroys a synchronized_pool_resource, releasing all allocated memory (virtual public member function)
operator= [deleted]	Copy assignment operator is deleted. synchronized_pool_resource is not copy assignable (public member function)
Public member functions
release	Release all allocated memory (public member function)
upstream_resource	Returns a pointer to the upstream memory resource (public member function)
options	Returns the options that control the pooling behavior of this resource (public member function)
Protected member functions
do_allocate [virtual]	Allocate memory (virtual protected member function)
do_deallocate [virtual]	Return memory to the pool (virtual protected member function)
do_is_equal [virtual]	Compare for equality with another memory_resource (virtual protected member function)