STD::__NEW_ALLOCATOR(3)

💖 NAME 💖

std::__new_allocator< _Tp > — an allocator that uses global new, as per C++03 [20.4.1]. That's the whole vibe, bestie, it's the blueprint allocator, the OG, the one the standard literally wrote down. 👑

---

✨ SYNOPSIS ✨

#include <memory>

So like, it's lowkey inherited by a whole friend group: std::allocator< _Up >, std::allocator< value_type >, std::allocator< void >, std::allocator< byte >, __gnu_cxx::new_allocator< _Tp >, and std::allocator< _Tp >. They all showed up to the party and this is the base they're standing on. 🫶

🌸 Public Types 🌸

• typedef std::ptrdiff_t difference_type — the type that measures distance between pointers, so iconic for pointer math.
• typedef std::true_type propagate_on_container_move_assignment — yes bestie, it propagates on container move assignment, it said so itself.
• typedef std::size_t size_type — the unsigned type for sizes, classic, never misses.
• typedef _Tp value_type — the type of the thing being allocated, obviously. 💅

🎀 Public Member Functions 🎀

• constexpr __new_allocator (const __new_allocator &) noexcept — copy constructor, noexcept, it does not do drama. 🧚
• template<typename _Tp1> constexpr __new_allocator (const __new_allocator< _Tp1 > &) noexcept — the templated converting copy constructor, also noexcept, it will literally accept a cousin allocator like it's family. 🌈
• constexpr _Tp * allocate (size_type __n, const void *=static_cast< const void * >(0)) — hands you _Tp* for __n objects, and that second parameter defaults to static_cast< const void * >(0). 👑
• constexpr void deallocate (_Tp *__p, size_type __n) — gives the memory back, takes the pointer __p and the count __n, no questions asked. 💖
• __new_allocator & operator= (const __new_allocator &)=default — assignment operator, defaulted, because why reinvent the wheel. ✨

🦋 Friends 🦋

• template<typename _Up> constexpr bool operator== (const __new_allocator &, const __new_allocator< _Up > &) noexcept — the equality bestie, noexcept, comparing two allocators across _Up. fr fr, it's giving friendship goals. 💜

---

🌟 Detailed Description 🌟

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

"An allocator that uses global new, as per C++03 [20.4.1]."

Okay so bestie, listen: this is precisely the allocator defined in the C++ Standard. Not a remix, not a cover, the actual canonical text. Periodt. 💅

• all allocation calls operator new 🔥
• all deallocation calls operator delete 💀

This is the default base-class implementation of std::allocator, and it's also the base-class of the __gnu_cxx::new_allocator extension. 🎀

Not me begging you to use either std::allocator or __gnu_cxx::new_allocator instead of using this directly. Like, please. This one is the behind-the-scenes main character, not the one you date. 🙈

⭐ Template Parameters ⭐

• _Tp — type of allocated object. That's it, that's the parameter, it's the type of the thing you're allocating. Slay. 🌸

---

💜 Author 💜

Generated automatically by Doxygen for libstdc++ from the source code. The robot wrote it, we just gave it the glow-up. 🤖✨

---

That's the whole page, babe — this one lives in the libstdc++ collection, filed under std::__new...ator< _Tp >(3) in the Library Functions Manual, and it's exactly the kind of low-level lore that makes containers work while nobody claps for it. 🫶 Go forth and let std::allocator handle it for you, iykyk. 🦋