std::destroy_at
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Memory management library
(exposition only*)
(C++11)
(C++23)
(C++11)
(C++17)
(C++11)
(C++11)
(C++20)
(C++20)
(C++17)
(C++11)
(C++17)
(C++20)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
destroy_at
(C++17)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
Uninitialized storage (until C++20)
(until C++20*)
(until C++20*)
(until C++20*)
Garbage collector support (until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)
(C++11)
(C++17)
(C++20)
(C++17)
(C++11)
(C++11)
(C++11)
(until C++17*)
(C++11)
(C++17)
(C++26)
(C++26)
(C++11)
(C++11)
(C++11)
(C++23)
(C++23)
(C++11)
(C++20)
(C++11)
(C++11)
(C++20)
(C++26)
Defined in header
<memory>
template< class T >
void destroy_at( T* p );
(since C++17) void destroy_at( T* p );
(constexpr since C++20)
If T
is not an array type, calls the destructor of the object pointed to by p, as if by p->~T().
If T
is an array type, the program is ill-formed(until C++20)recursively destroys elements of *p in order, as if by calling std::destroy (std::begin (*p), std::end (*p))(since C++20).
[edit] Parameters
p
-
a pointer to the object to be destroyed
[edit] Possible implementation
template<class T> constexpr void destroy_at(T* p) { if constexpr (std::is_array_v <T>) for (auto& elem : *p) (destroy_at)(std::addressof (elem)); else p->~T(); } // C++17 version: // template<class T> void destroy_at(T* p) { p->~T(); }
[edit] Notes
destroy_at
deduces the type of object to be destroyed and hence avoids writing it explicitly in the destructor call.
When destroy_at
is called in the evaluation of some constant expression e, the argument p must point to an object whose lifetime began within the evaluation of e.
[edit] Example
The following example demonstrates how to use destroy_at
to destroy a contiguous sequence of elements.
Run this code
#include <iostream> #include <memory> #include <new> struct Tracer { int value; ~Tracer() { std::cout << value << " destructed\n"; } }; int main() { alignas(Tracer) unsigned char buffer[sizeof(Tracer) * 8]; for (int i = 0; i != 8; ++i) new(buffer + sizeof(Tracer) * i) Tracer{i}; // manually construct objects auto ptr = std::launder (reinterpret_cast<Tracer*>(buffer)); for (int i = 0; i != 8; ++i) std::destroy_at(ptr + i); }
Output:
0 destructed 1 destructed 2 destructed 3 destructed 4 destructed 5 destructed 6 destructed 7 destructed