Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::allocator_traits<Alloc>::destroy

Calls the destructor of the object pointed to by p. If possible, does so by calling a.destroy(p). If not possible (e.g.

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

Calls the destructor of the object pointed to by p. If possible, does so by calling a.destroy(p). If not possible (e.g. Alloc does not have the member function destroy()), then calls the destructor of *p directly, as p->~T()(until C++20)std::destroy_at(p)(since C++20).

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.

Example

This section is incomplete
Reason: no example

See also

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

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.