std::experi...ce::allocate(3)

🎀 std::experi...ce::allocate(3) 🎀

okay so bestie, this page is from the C++ Standard Libary manual — yes, “Libary,” exactly like that, iykyk — and we’re about to make std::experimental::pmr::memory_resource::allocate make sense. no cap. ✨

✨ NAME ✨

std::experimental::pmr::memory_resource::allocate — std::experimental::pmr::memory_resource::allocate. yep, the function and the page have the exact same name, and honestly? iconic 💅

🦋 Synopsis 🦋

void* allocate( std::size_t bytes, std::size_t alignment   (library
fundamentals TS)
= alignof(std::max_align_t) );

This one is the (library fundamentals TS) version, periodt.

It allocates storage with a size of at least bytes bytes. the returned storage is aligned to the specified alignment if that alignment is supported, and to alignof(std::max_align_t) otherwise. 🌸

It’s equivalent to return do_allocate(bytes, alignment);. literally that. 🫶

😭 Exceptions 😭

It throws an exception if storage of the requested size and alignment cannot be obtained. no storage? no vibes. it throws. 💀

🔥 See also 🔥

• do_allocate allocates memory [virtual] (virtual protected member function)

🏷️ Category 🏷️

• Noindexed pages

source/version/date tea ☕: http://cppreference.com, 2024.06.10, and the footer tag std::experi...ce::allocate(3) — signed, sealed, slayed. 💖