std::experi...do_allocate(3)

💅 std::experimental::pmr::monotonic_buffer_resource::do_allocate

okay so real quick — this is a page from the C++ Standard Library manual, and we're talking about the std::experimental::pmr::monotonic_buffer_resource::do_allocate function. yes the name is a whole paragraph, we don't talk about it 💀

---

✨ NAME ✨

std::experimental::pmr::monotonic_buffer_resource::do_allocate — like, literally the exact same thing again bestie, std::experimental::pmr::monotonic_buffer_resource::do_allocate. the manual is just being extra 🎀

---

🦋 Synopsis

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

library fundamentals TS energy ✨

---

🌸 DESCRIPTION 🌸

It allocates storage. that's the whole vibe.

So here's the tea ☕ — if the current buffer has enough unused space to fit a block with the specified size and alignment, then it allocates the return block right out of the current buffer. easy, no drama, ate 💅

Otherwise? it allocates a new buffer by calling upstream_resource()->allocate(n, m), where n is not less than the greater of bytes and the next buffer size, and m is not less than alignment. then it sets the new buffer as the current buffer, increases the next buffer size by an implementation-defined growth factor (which is not necessarily integral — yes that's a real caveat, don't come for me 🙈), and then allocates the return block from the newly allocated buffer. main character energy fr fr 👑

---

💖 Return value

A pointer to allocated storage of at least bytes bytes in size, aligned to the specified alignment if such alignment is supported, and to alignof(std::max_align_t) otherwise. slay 🫶

---

🔥 Exceptions

Throws nothing unless calling allocate() on the upstream memory resource throws. that's it, that's the whole rule 🧚

---

⭐ See also

• allocate — allocates memory (public member function of std::experimental::pmr::memory_resource)
• do_allocate [virtual] — allocates memory (virtual protected member function of std::experimental::pmr::memory_resource)

---

🎀 Category:

• Noindexed pages

---

ngl the [virtual] tag on that second one is doing a lot of heavy lifting — it's a virtual protected member function, so mind your access, bestie 😭

---

okay that's the whole page, you're welcome 💜 this one came straight from http://cppreference.com, dated 2024.06.10, from the std::experi...do_allocate(3) page — mwah, go allocate something responsibly ✨🌸