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

💖 NAME 💖

std::pmr::polymorphic_allocator::deallocate_object — std::pmr::polymorphic_allocator::deallocate_object. Yep, the NAME section said it twice and we're keeping both, bestie. This is the std::pmr::p...cate_object(3) page from the C++ Standard Libary manual. 🫶

✨ Synopsis ✨

Okay so it's a template, and it's been a thing since C++20:

template< class U >
void deallocate_object( U* p, std::size_t n = 1 );

It deallocates the storage pointed to by p. Big caveat: p must have been allocated from a std::pmr::memory_resource x that compares equal to *resource(), using x.allocate(n * sizeof(U), alignof(U)) — typically through a call to allocate_object<U>(n). The provenance is giving required, no cap. 💅

It's equivalent to deallocate_bytes(p, n * sizeof(U), alignof(U));.

🎀 Parameters 🎀

• p — pointer to the memory to deallocate.
• n — number of objects of type U the memory was for.

💀 Exceptions 💀

Throws nothing. Literally zero drama. ✨

🦋 Notes 🦋

This function was introduced for use with the fully-specialized allocator std::pmr::polymorphic_allocator<>, but it may be useful in any specialization. Highkey flexible icon behavior. 🌈

🌸 See also 🌸

• deallocate_bytes — frees raw memory obtained from allocate_bytes (C++20) (public member function).
• delete_object — destroys and deallocates an object (C++20) (public member function).
• deallocate — deallocates storage using the allocator [static] (public static member function of std::allocator_traits<Alloc>).
• deallocate — deallocates memory (public member function of std::pmr::memory_resource).

Later, bestie! 🫶 Source/version: http://cppreference.com; date: 2024.06.10. That was the std::pmr::p...cate_object(3) page — mwah! 💖🎀