Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. — Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the develop branch, built from commit f8f3d75ae3.

recycling_allocator

An allocator that caches memory blocks in thread-local storage for reuse.

template<
    typename T>
class recycling_allocator

Types

Name	Description
rebind	Rebind the allocator to another value_type.
value_type	The type of object allocated by the recycling allocator.

Member Functions

Name	Description
allocate	Allocate memory for the specified number of values.
deallocate	Deallocate memory for the specified number of values.
operator!=	Inequality operator. Always returns false.
operator==	Equality operator. Always returns true.
recycling_allocator [constructor]	Default constructor. — Converting constructor.

The @recycling_allocator uses a simple strategy where a limited number of small memory blocks are cached in thread-local storage, if the current thread is running an io_context or is part of a thread_pool.

Requirements

Header: boost/asio/recycling_allocator.hpp

Convenience header: boost/asio.hpp