std::destroy_n (3) - Linux Man Pages
Defined in header <memory>
template< class ForwardIt, class Size > (1) (since C++17)
ForwardIt destroy_n( ForwardIt first, Size n );
template< class ExecutionPolicy, class ForwardIt, class Size > (2) (since C++17)
ForwardIt destroy_n( ExecutionPolicy&& policy, ForwardIt first, Size n );
1) Destroys the n objects in the range starting at first, as if by
2) Same as (1), but executed according to policy. This overload does not participate in overload resolution unless std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> is true
ForwardIt must meet the requirements of LegacyForwardIterator.
No increment, assignment, comparison, or indirection through valid instances of ForwardIt may throw exceptions.
The end of the range of objects that has been destroyed (i.e., std::next(first, n)).
Linear in n.
The overload with a template parameter named ExecutionPolicy reports errors as follows:
* If execution of a function invoked as part of the algorithm throws an exception and ExecutionPolicy is one of the standard_policies, std::terminate is called. For any other ExecutionPolicy, the behavior is implementation-defined.
* If the algorithm fails to allocate memory, std::bad_alloc is thrown.
The following example demonstrates how to use destroy_n to destroy a contiguous sequence of elements.
// Run this code
destroy destroys a range of objects
destroy_at destroys an object at a given address