STD::PMR_POLYMORPHIC_ALLOCATOR(3)

💖 NAME 💖

std::pmr::polymorphic_allocator< _Tp > — bestie it's a Class template called polymorphic_allocator. That's the whole vibe. It's a template, it's polymorphic, it allocates, slay. ✨

(also hi, you're reading the Library Functions Manual page for it, section 3, we love a numbered-section moment 🫶)

---

✨ SYNOPSIS ✨

First things first, you gotta pull it in:

#include <memory_resource>

That's it. That's the include. No cap. 🦋

🎀 Public Types 🎀

• using value_type — the public type, just chillin' right there. Yes, that's genuinely all it says. Iconic minimalism. 💅

🌸 Public Member Functions 🌸

okay so here's the whole roster, every single one, no skipping, I promised:

• polymorphic_allocator (const polymorphic_allocator &__other)=default — copy constructor, and it's =default, so the compiler handles it and honestly? good for it.
• template<typename _Up> polymorphic_allocator (const polymorphic_allocator< _Up > &__x) noexcept — converting constructor from a polymorphic_allocator of a different type _Up. noexcept, so it will NOT be the one to betray you.
• polymorphic_allocator (memory_resource *__r) noexcept — build one from a memory_resource *. Also noexcept. We love a constructor that keeps its promises. 🫶
• _Tp * allocate (size_t __n) — gimme __n of them, hands back a _Tp *.
• template<typename _Tp1, typename... _Args> void construct (_Tp1 *__p, _Args &&... __args) — constructs a thing at __p, forwarding literally all the __args (it's a variadic, periodt).
• void deallocate (_Tp *__p, size_t __n) noexcept — give the memory back. noexcept. bye! 👋
• template<typename _Up> void destroy (_Up *__p) — destroys the _Up sitting at __p.
• polymorphic_allocator & operator= (const polymorphic_allocator &)=delete — 🚨 DELETED. You cannot assign one to another. It's not a bug, it's a boundary. Respect the boundary bestie, the compiler will absolutely yell at you and it will be correct. 💀
• memory_resource * resource () const noexcept — hands you back the memory_resource *. const, noexcept, a whole green-flag king. 👑
• polymorphic_allocator select_on_container_copy_construction () const noexcept — the special little guy that decides what a container does when it gets copied. const and noexcept, obviously, because it's that kind of method. ✨

🌈 Friends 🌈

• bool operator== (const polymorphic_allocator &__a, const polymorphic_allocator &__b) noexcept — equality comparison between two of them, noexcept, sitting here as a friend like the main character who doesn't need to be a member. 💜

---

🦋 Detailed Description 🦋

so, template time:

template<typename _Tp>
    class std::pmr::polymorphic_allocator< _Tp >

and the description is literally just:

Class template polymorphic_allocator.

that's it. that's the tea. short, sweet, self-assured. 🍓

Since: C++17 — so if you're on C++17 or later, this is your moment. If you're not... bestie. 😭

---

🎀 Author 🎀

Generated automatically by Doxygen for libstdc++ from the source code. Not a human, not a girlie, just Doxygen doing its little robot thing. It ate, honestly. 🤖✨

---

and that's the page! 💅 thanks for reading all the way to the bottom, you're a real one. this was the libstdc++ section 3 manual page for std::pmr::polymorphic_allocator< _Tp >, so go forth and allocate responsibly, mwah 🫶💖🌈