__GNU_CXX::__MT_ALLOC(3)

💖 NAME 💖

__gnu_cxx::__mt_alloc< _Tp, _Poolp > — bestie, this is a fixed size (power of 2) allocator which — when compiled with thread support — will maintain one freelist per size per thread plus a global one. Steps are taken to limit the per thread freelist sizes (by returning excess back to the global list). ✨

---

✨ SYNOPSIS ✨

#include <mt_allocator.h>

Inherits __gnu_cxx::__mt_alloc_base< _Tp >. 🫶

---

🎀 Public Types 🎀

• typedef _Poolp __policy_type — the policy type, literally right there in the name 💅
• typedef _Poolp::pool_type __pool_type — the pool type, pulled straight off the policy
• typedef const _Tp * const_pointer — pointer, but make it const 🧊
• typedef const _Tp & const_reference — reference, but make it const
• typedef std::ptrdiff_t difference_type — for when you gotta know the distance between two pointers, no cap
• typedef _Tp * pointer — your classic pointer, iconic
• typedef std::true_type propagate_on_container_move_assignment — yes, it propagates on container move assignment, periodt
• typedef _Tp & reference — reference to _Tp, we love to see it
• typedef std::size_t size_type — sizes, sizes, sizes 🌸
• typedef _Tp value_type — the actual thing being allocated, the main character

---

🦋 Public Member Functions 🦋

• __mt_alloc (const __mt_alloc &) noexcept — copy constructor, and she's noexcept, as she should be 👑
• template<typename _Tp1, typename _Poolp1> __mt_alloc (const __mt_alloc< _Tp1, _Poolp1 > &) noexcept — the templated converting copy constructor, also noexcept 🔥
• const __pool_base::_Tune _M_get_options () — grab the current tuning options
• void _M_set_options (__pool_base::_Tune __t) — set the tuning options to __t
• const_pointer address (const_reference __x) const noexcept — hand over the address of a const __x
• pointer address (reference __x) const noexcept — hand over the address of __x
• pointer allocate (size_type __n, const void *=0) — allocate __n of the things, with that sneaky little const void *=0 hint param ✨
• template<typename _Up, typename... _Args> void construct (_Up *__p, _Args &&... __args) — construct a _Up at __p, forwarding all the __args like the good little perfect-forwarder she is
• void deallocate (pointer __p, size_type __n) — give it back, __n items from __p
• template<typename _Up> void destroy (_Up *__p) — bye bye, __p 💀
• size_type max_size () const noexcept — the biggest size she can handle, and she's noexcept about it

---

🌸 Detailed Description 🌸

template<typename _Tp, typename _Poolp = __common_pool_policy<__pool, true>>
class __gnu_cxx::__mt_alloc< _Tp, _Poolp >

"This is a fixed size (power of 2) allocator which - when compiled with thread support - will maintain one freelist per size per thread plus a global one. Steps are taken to limit the per thread freelist sizes (by returning excess back to the global list).

Okay so the tea ☕: every thread gets its own freelist per size, there's also one big global freelist, and the allocator is very careful not to let any single thread's freelists get out of hand — it sends the excess back to the global list. Vibe check: passed. 🌈

Further details, go read the lore yourself bestie:

https://gcc.gnu.org/onlinedocs/libstdc++/manual/mt_allocator.html

---

👑 Author 👑

Generated automatically by Doxygen for libstdc++ from the source code. So like, nobody actually sat down and hand-wrote this, the robots did it. 🤖💖

---

That's the whole page, bestie — and yes, it came to you straight from libstdc++, the __gnu_cxx::..., _Poolp >(3) manual, iykyk. Go forth and allocate responsibly. 🎀✨🦋