std::pmr::monotonic_buffer_resource - A memory resource that allocates from a fixed-size buffer.
Contents
Detailed Description
A memory resource that allocates from a fixed-size buffer.
The main feature of a pmr::monotonic_buffer_resource is that its do_deallocate does nothing. This makes
it very fast because there is no need to manage a free list, and every allocation simply returns a new
block of memory, rather than searching for a suitably-sized free block. Because deallocating is a no-op,
the amount of memory used by the resource only grows until release() (or the destructor) is called to
return all memory to upstream.
A monotonic_buffer_resource can be initialized with a buffer that will be used to satisfy all allocation
requests, until the buffer is full. After that a new buffer will be allocated from the upstream resource.
By using a stack buffer and pmr::null_memory_resource() as the upstream you can get a memory resource
that only uses the stack and never dynamically allocates.
Since
C++17
Member Function Documentation
void*std::pmr::monotonic_buffer_resource::do_allocate(size_t__bytes,size_t__alignment)[inline],[override],[protected],[virtual]
Implements std::pmr::memory_resource.
voidstd::pmr::monotonic_buffer_resource::do_deallocate(void*,size_t,size_t)[inline],[override],[protected],[virtual]
Implements std::pmr::memory_resource.
boolstd::pmr::monotonic_buffer_resource::do_is_equal(constmemory_resource&__other)const[inline],[override],[protected],[virtual],[noexcept]
Implements std::pmr::memory_resource.
Name
std::pmr::monotonic_buffer_resource - A memory resource that allocates from a fixed-size buffer.
Synopsis
#include <memory_resource>
Inherits std::pmr::memory_resource.
PublicMemberFunctionsmonotonic_buffer_resource (const monotonic_buffer_resource &)=deletemonotonic_buffer_resource (memory_resource *__upstream) noexcept
monotonic_buffer_resource (size_t __initial_size) noexcept
monotonic_buffer_resource (size_t __initial_size, memory_resource *__upstream) noexcept
monotonic_buffer_resource (void *__buffer, size_t __buffer_size) noexcept
monotonic_buffer_resource (void *__buffer, size_t __buffer_size, memory_resource *__upstream) noexcept
void * allocate (size_t __bytes, size_t __alignment=_S_max_align)
voiddeallocate (void *__p, size_t __bytes, size_t __alignment=_S_max_align)
bool is_equal (const memory_resource &__other) const noexcept
monotonic_buffer_resource & operator= (const monotonic_buffer_resource &)=deletevoidrelease () noexcept
memory_resource * upstream_resource () const noexcept
ProtectedMemberFunctionsvoid * do_allocate (size_t __bytes, size_t __alignment) overridevoiddo_deallocate (void *, size_t, size_t) override
bool do_is_equal (const memory_resource &__other) const noexcept override