std::pmr::p...cate_object(3)

💖 NAME 💖

okay bestie, this is the C++ Standard Libary manual, section (3), and the function is std::pmr::polymorphic_allocator::allocate_object — the short description is literally the same thing: std::pmr::polymorphic_allocator::allocate_object. iconic, honestly 💅

---

✨ Synopsis ✨

template< class U >                                     (since C++20)
[[nodiscard]] U* allocate_object( std::size_t n = 1 );

Allocates storage for n objects of type U using the underlying memory resource.

If std::numeric_limits<std::size_t>::max() / sizeof(U) < n, it throws std::bad_array_new_length; otherwise it’s equivalent to return static_cast<U*>(allocate_bytes(n * sizeof(U), alignof(U)));.

---

🎀 Parameters 🎀

• n — the number of objects to allocate storage for. That’s the whole parameter, bestie; she’s simple and she knows it 🫶

---

🌸 Return value 🌸

A pointer to the allocated storage. slay ✨

---

🦋 Notes 🦋

This function was introduced for use with the fully-specialized allocator std::pmr::polymorphic_allocator<>, but it may be useful in any specialization as a shortcut to avoid having to rebind from std::pmr::polymorphic_allocator<T> to std::pmr::polymorphic_allocator<U>.

Since U is not deduced, it must be provided as a template argument when calling this function. no cap, you gotta say it with your chest 💜

---

😭 Exceptions 😭

Throws std::bad_array_new_length if n > std::numeric_limits<std::size_t>::max() / sizeof(U); may also be any exceptions thrown by the call to resource()->allocate.

bestie, read that condition carefully — this is the “too much math, too much size” situation, and she WILL throw 💀

---

👀 See also 👀

• allocate_bytes — allocate raw aligned memory from the underlying resource (C++20) (public member function)
• new_object — allocates and constructs an object (C++20) (public member function)
• allocate — allocate memory (public member function)
• allocate [static] — allocates uninitialized storage using the allocator (public static member function of std::allocator_traits<Alloc>)
• allocate — allocates memory (public member function of std::pmr::memory_resource)

---

and that’s the whole page, bestie 🫶 source/version: http://cppreference.com · date: 2024.06.10 · footer tag: std::pmr::p...cate_object(3) — mwah 💋✨