std::pmr::m...ce::release(3)

💅 NAME

std::pmr::monotonic_buffer_resource::release — yeah bestie, that's the whole name, stated twice in the original because they really wanted you to know 💖. This page lives in the C++ Standard Libary manual (yes, that's how they spell "Libary" over there, we are not fixing it, it's iconic) — section (3), the library section, iykyk.

✨ Synopsis

void release();

(since C++17) 🌸

So here's the tea: release() releases all allocated memory by calling the deallocate function on the upstream memory resource, as necessary 🫶. It also resets the current buffer and the next buffer size to their initial values at construction — like, back to factory settings, fresh out of the box ✨.

And the important bit (fr fr, don't skip this): memory is released back to the upstream resource even if deallocate has not been called for some of the allocated blocks 👑. Yes, even those. It doesn't care. It's cleaning house regardless 💅.

💀 Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards 😭 (yes, they go back and patch the past, main character energy):

• LWG 3120 — applied to C++17. Behavior as published: release might not make the initial buffer reusable if provided. Correct behavior: required to do so. ⭐

Ngl, this one's a glow-up: the standard said "meh, maybe" and the committee said "no babes, required." Periodt.

🫶 See also

• deallocate — deallocates memory (public member function of std::pmr::memory_resource) 🦋

Okay that's the whole page bestie, go forth and release your buffers responsibly 🌈💜

http://cppreference.com · 2024.06.10 · std::pmr::m...ce::release(3) — mwah, that's the sign-off, ily, bye 🎀