std::pmr::m...do_allocate(3)

💖 NAME 💖

Okay so bestie, this page is std::pmr::memory_resource::do_allocate — and yes, the NAME line is basically <pink>std::pmr::memory_resource::do_allocate</pink> dash <pink>std::pmr::memory_resource::do_allocate</pink> again. Iconic redundancy, no notes 💅.

The manual name folded in near the top is C++ Standard Libary (spelling exactly like the header, no cap 😭🫶). Page vibes: std::pmr::memory_resource::do_allocate(3).

✨ Synopsis ✨

The signature is exactly this, bestie:

virtual void* do_allocate( std::size_t bytes, std::size_t alignment )

It's marked (since C++17), and it ends with = 0; — yes, that = 0; is literally part of the synopsis, not a typo 🌸.

What it does: allocates storage with a size of at least bytes bytes, aligned to the specified alignment.

And the rule that is not playing around: alignment shall be a power of two. Periodt 🔥.

😭 Exceptions 😭

Throws an exception if storage of the requested size and alignment cannot be obtained. That's the exception lore, and it's giving "handle it or catch feelings" 💀.

🩹 Defect reports 🩹

The following behavior-changing defect reports were applied retroactively to previously published C++ standards:

• DR: LWG 2843 — Applied to: C++17 — Behavior as published: contradictory — Correct behavior: handling of unsupported alignment throws an exception.

👑 See also 👑

• allocate — allocates memory (public member function)

💖 That's the page, bestie. Source/version: http://cppreference.com · date: 2024.06.10 — now go forth and allocate with main-character energy 💅✨