std::allocator_traits<Alloc>::destroy (3) - Linux Manuals

std::allocator_traits<Alloc>::destroy: std::allocator_traits<Alloc>::destroy

NAME

std::allocator_traits<Alloc>::destroy - std::allocator_traits<Alloc>::destroy

Synopsis


Defined in header <memory>
template< class T > (since C++11)
static void destroy( Alloc& a, T* p );


Calls the destructor of the object pointed to by p. If possible, does so by calling a.destroy(p). If not possible (e.g. a does not have the member function destroy()), then calls the destructor of *p directly, as p->~T().

Parameters


a - allocator to use for destruction
p - pointer to the object being destroyed

Return value


(none)

Notes


Because this function provides the automatic fall back to direct call to the destructor, the member function destroy() is an optional Allocator requirement since C++11.

See also


destroy destructs an object in allocated storage
                      (public member function of std::allocator<T>)
(deprecated in C++17)
(removed in C++20)