STD::ALLOCATOR(3)

✨ NAME ✨

std::allocator< _Tp > — the standard allocator, exactly as C++03 says it should be, straight outta [20.4.1]. 💖

This is your <memory> era, bestie — the whole page lives in the libstdc++ manual (that's the Library Functions Manual, section 3, so it's a library call, not a command, iykyk).

---

🌸 SYNOPSIS 🌸

#include <memory>

And okay, this one inherits std::__new_allocator< _Tp >. So like, the parent class did a lot of the heavy lifting and std::allocator is out here being the glow-up. 💅

---

🎀 Public Types 🎀

• typedef ptrdiff_t difference_type — the type it uses when it's talking about differences between things (signed, obviously, 'cause differences go both ways).
• using propagate_on_container_move_assignment — yes bestie, this alias exists. It's part of the whole "does the allocator tag along when the container gets move-assigned" situation.
• typedef size_t size_type — how it measures sizes. Unsigned, standard issue.
• typedef _Tp value_type — the type of the thing you're actually allocating. That's literally what _Tp is here for. 👑

---

🦋 Public Member Functions 🦋

• constexpr allocator (const allocator &__a) noexcept — copy constructor. Copies another allocator, and it's noexcept, so it will not be dramatic about it.
• template<typename _Tp1> constexpr allocator (const allocator< _Tp1 > &) noexcept — the conversion constructor. Yes, you can build one of these from an allocator of a different _Tp1. noexcept again. Very chill. 😌
• constexpr _Tp * allocate (size_type __n, const void *=static_cast< const void * >(0)) — the allocate that takes a size and an optional hint pointer, which defaults to static_cast<const void *>(0). Gives you back a _Tp *.
• constexpr _Tp * allocate (size_t __n) — the simple allocate. Just give it __n and it hands you a _Tp *. That's it, that's the vibe.
• constexpr allocation_result< _Tp *, size_t > allocate_at_least (size_t __n) — allocate at least __n, and get back an allocation_result< _Tp *, size_t > so you know what you actually got. Overachieving, but make it constexpr. ✨
• constexpr void deallocate (_Tp *__p, size_t __n) — give back what you took: the pointer __p and the size __n. Cleanup era. 🧹
• allocator & operator= (const allocator &)=default — the copy assignment, defaulted. Nothing custom, nothing weird, just the compiler's finest work.

---

💜 Friends 💜

• constexpr bool operator== (const allocator &, const allocator &) noexcept — friend of the class, compares two allocators, returns a bool, and it's noexcept. Equality rights. 🫶

---

🌈 Related Symbols 🌈

Heads up: these are not member symbols. They just live nearby.

• template<typename _T1, typename _T2> constexpr bool operator== (const allocator< _T1 > &, const allocator< _T2 > &) noexcept — the cross-type comparison. Two allocators with different template params can still be compared for equality, and yes, it's constexpr and noexcept. Iconic, honestly.

---

⭐ Detailed Description ⭐

template<typename _Tp>
class std::allocator< _Tp >

"The standard allocator, as per C++03 [20.4.1]."

That's the whole description. Short, sweet, main character energy. 💖

Want the further details? The docs point you here:

https://gcc.gnu.org/onlinedocs/libstdc++/manual/memory.html#std.util.memory.allocator

🍓 Template Parameters 🍓

• _Tp — type of allocated object. That's the one. That's the whole parameter. 💅

---

👑 Author 👑

Generated automatically by Doxygen for libstdc++ from the source code. So like, a robot wrote this and I'm just here giving it the personality transplant it deserved. 🤖✨

---

Okay bestie, that's the whole page — this is libstdc++, std::allocator< _Tp >(3), and that's a wrap fr fr. Go forth and allocate responsibly, and remember: whatever you allocate, you deallocate. No leaks in this group chat. 💖🎀🦋💅