std::pmr::pool_options(3)

💖 std::pmr::pool_options — from the C++ Standard Libary manual 💖

🌸 NAME 🌸

std::pmr::pool_options — yes bestie, that’s the name, and it’s giving “options bag for pool resources” energy. 💅

✨ Synopsis ✨

Defined in header <memory_resource>
struct pool_options;                 (since C++17)

Okay so std::pmr::pool_options is a set of constructor options for pool resources including std::pmr::synchronized_pool_resource and std::pmr::unsynchronized_pool_resource. Not me being dramatic — that is literally what it is. 🦋

🎀 Data members 🎀

Two members, both std::size_t, both lowkey important. Here’s the tea:

• std::size_t max_blocks_per_chunk; — the maximum number of blocks that will be allocated at once from the upstream std::pmr::memory_resource to replenish the 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 field and may use different values for different pools. 🫶
• std::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 std::pmr::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 field. ✨

🦋 See also 🦋

• synchronized_pool_resource (C++17) — a thread-safe std::pmr::memory_resource for managing allocations in pools of different block sizes (class). 🔥
• unsynchronized_pool_resource (C++17) — a thread-unsafe std::pmr::memory_resource for managing allocations in pools of different block sizes (class). 💀

That’s the whole page, bestie. Source/version: http://cppreference.com · date: 2024.06.10 — xoxo, your C++ bestie 💅🎀