[mem.res.pool.options] (original) (raw)

20 Memory management library [mem]

20.5 Memory resources [mem.res]

20.5.5 Pool resource classes [mem.res.pool]

20.5.5.2 pool_options data members [mem.res.pool.options]

The members of pool_optionscomprise a set of constructor options for pool resources.

The effect of each option on the pool resource behavior is described below:

size_t max_blocks_per_chunk;

The maximum number of blocks that will be allocated at once from the upstream memory resource ([mem.res.monotonic.buffer]) to replenish a pool.

If the value of max_blocks_per_chunk is zero or is greater than an implementation-defined limit, that limit is used instead.

The implementation may choose to use a smaller value than is specified in this member and may use different values for different pools.

size_t largest_required_pool_block;

The largest allocation size that is required to be fulfilled using the pooling mechanism.

Attempts to allocate a single block larger than this threshold will be allocated directly from the upstream memory resource.

If largest_required_pool_block is zero or is greater than an implementation-defined limit, that limit is used instead.

The implementation may choose a pass-through threshold larger than specified in this member.