std::destroy_n
来自 zh.cppreference.net
| 定义于头文件 <memory>
|
||
template< class ForwardIt, class Size >
ForwardIt destroy_n( ForwardIt first, Size count );
|
(1) | (C++17 起) (C++20 起 constexpr) |
template< class ExecutionPolicy, class ForwardIt, class Size >
ForwardIt destroy_n( ExecutionPolicy&& policy, ForwardIt first, Size count );
|
(2) | (C++17 起) |
1) 销毁目标范围
count 中的前 [first, last) 个元素，如同通过
for (; count > 0; (void) ++first, --count)
std::destroy_at(std::addressof(*first));
return first;
2) 同 (1)，但按
policy 执行。 此重载仅在以下表达式的值为
true 时参与重载决议：
|
|
(C++20 前) |
|
|
(C++20 起) |
参数
| first | - | 要销毁的元素范围的起始 |
| count | - | 要销毁的元素数量 |
| policy | - | 使用的执行策略 |
| 类型要求 | ||
-ForwardIt必须满足老式向前迭代器（LegacyForwardIterator）的要求。
| ||
-对有效实例ForwardIt进行的递增、赋值、比较或解引用操作不得抛出异常。
| ||
返回值
如上所述。
异常
2) 在执行过程中：
- 如果并行化所需的临时内存资源不可用，则会抛出std::bad_alloc。
- 如果通过算法参数访问对象时抛出未捕获的异常，则行为由执行策略决定（对于标准策略，会调用std::terminate）。
示例
演示如何使用destroy_n销毁连续的元素序列。
运行此代码
#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) * 4];
for (int i = 0; i < 4; ++i)
new (buffer + sizeof(Tracer) * i) Tracer{i}; // manually construct objects
auto ptr = std::launder(reinterpret_cast<Tracer*>(buffer));
std::destroy_n(ptr, 4);
}
输出：
0 destructed
1 destructed
2 destructed
3 destructed
参见
|
(C++17)
|
销毁一个对象范围
(函数模板) |
|
(C++17)
|
销毁给定地址处的对象
(函数模板) |
|
(C++20)
|
销毁范围内指定数量的对象
(算法函数对象) |