STD::__NEW_ALLOCATOR(3cxx)

hey bestie 💖 this is the std::__new_allocator< _Tp > page, and the manual name is 3cxx — folded in right here so we can get into it. no cap, we're about to make an allocator manual feel like a group chat.

💖 NAME 💖

std::__new_allocator< _Tp > — an allocator that uses global new, as per C++03 [20.4.1]. That's the name, that's the vibe, periodt.

✨ SYNOPSIS ✨

#include <memory>

Inherited by std::allocator< value_type >, __gnu_cxx::new_allocator< _Tp >, and std::allocator< _Tp >.

🎀 Public Types 🎀

• typedef std::ptrdiff_t difference_type — the difference type, iconic.
• typedef std::true_type propagate_on_container_move_assignment — yes, the whole long name is the type, and it's std::true_type.
• typedef std::size_t size_type — size type, we love to see it.
• typedef _Tp value_type — value type is _Tp, simple as that.

🌸 Public Member Functions 🌸

Here's the function squad, with every signature kept exactly:

• copy constructor — constexpr __new_allocator (const __new_allocator &) noexcept
• template constructor — template<typename _Tp1 > constexpr __new_allocator (const __new_allocator< _Tp1 > &) noexcept
• allocate — exact signature:

_Tp * allocate (size_type __n, const void *=static_cast< const void *
           >(0))

• deallocate — void deallocate (_Tp *__p, size_type __n)
• copy assignment — __new_allocator & operator= (const __new_allocator &)=default

🦋 Friends 🦋

• template<typename _Up > constexpr bool operator== (const __new_allocator &, const __new_allocator< _Up > &) noexcept — the friend equality operator, keeping it friendly.

👑 Detailed Description 👑

The class is:

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

And its quoted description is "An allocator that uses global new, as per C++03 [20.4.1]."

This is precisely the allocator defined in the C++ Standard. Not me guessing — the manual says it. periodt.

Then the bullet points:

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

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

You should use either std::allocator or __gnu_cxx::new_allocator instead of using this directly. That's the manual's actual warning, and I'm keeping it loud 💅.

Template Parameters

• _Tp — Type of allocated object.

💜 Author 💜

Generated automatically by Doxygen for libstdc++ from the source code. So no human author to credit here, just Doxygen doing its thing.

okay bye bestie 🫶 the footer says libstdc++, the manual tag is 3cxx, and there's no extra date line in the footer — so that's the whole cute sign-off, mwah 💜✨