命名空间
变体
操作

std::ranges::destroy_n

来自 cppreference.com
< cpp‎ | memory
 
 
实用程序库
语言支持
类型支持 (基本类型,RTTI)
库功能测试宏 (C++20)
动态内存管理
程序实用程序
协程支持 (C++20)
可变参数函数
调试支持
(C++26)
三元比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用程序
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)

 
动态内存管理
未初始化内存算法
受约束的未初始化内存算法
分配器
垃圾回收支持
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)



 
在头文件 <memory> 中定义
调用签名
template< no-throw-input-iterator I >

    requires std::destructible<std::iter_value_t<I>>

constexpr I destroy_n( I first, std::iter_difference_t<I> n ) noexcept;
(自 C++20 起)

销毁从 first 开始的范围内的 n 个对象,等效于

此页面上描述的函数式实体是niebloids,即

实际上,它们可以实现为函数对象,或者使用特殊的编译器扩展。

内容

[编辑] 参数

first - 要销毁的元素范围的开始
n - 要销毁的元素数量

[编辑] 返回值

已销毁的对象范围的末尾。

[编辑] 复杂度

n 线性。

[编辑] 可能的实现

struct destroy_n_fn
{
    template<no-throw-input-iterator I>
        requires std::destructible<std::iter_value_t<I>>
    constexpr I operator()(I first, std::iter_difference_t<I> n) const noexcept
    {
        for (; n != 0; (void)++first, --n)
            std::ranges::destroy_at(std::addressof(*first));
        return first;
    }
};
 
inline constexpr destroy_n_fn destroy_n{};

[编辑] 示例

以下示例演示了如何使用 ranges::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) * 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));
 
    std::ranges::destroy_n(ptr, 8);
}

输出

0 destructed
1 destructed
2 destructed
3 destructed
4 destructed
5 destructed
6 destructed
7 destructed

[编辑] 另请参阅

销毁给定地址上的对象
(niebloid)[编辑]
销毁对象范围
(niebloid)[编辑]
(C++17)
销毁范围内一定数量的对象
(函数模板) [编辑]