BloombergLP::bdlma::BufferedSequentialPool::BufferedSequentialPool

Create a buffered sequential pool backed by the specified buffer.

Synopsis

Declared in <bdlma_bufferedsequentialpool.h>

BufferedSequentialPool(
    char* buffer,
    bsls::Types::size_type size,
    bslma::Allocator* basicAllocator = 0);

Description

Create a buffered sequential pool for allocating memory blocks from the specified external buffer having the specified size (in bytes), or from an internal buffer (after the external buffer is exhausted). Optionally specify a growthStrategy used to control buffer growth. If a growthStrategy is not specified, geometric growth is used. Optionally specify an alignmentStrategy used to align allocated memory blocks. If an alignmentStrategy is not specified, natural alignment is used. Optionally specify a basicAllocator used to supply memory should the capacity of buffer be exhausted. If basicAllocator is 0, the currently installed default allocator is used. The behavior is undefined unless 0 < size, and buffer has at least size bytes. Note that, due to alignment effects, it is possible that not all size bytes of memory in buffer can be used for allocation. Also note that no limit is imposed on the size of the internal buffers when geometric growth is used. Also note that when constant growth is used, the size of the internal buffers will always be the same as size.