std::unique_ptr<T,Deleter>::reset

< cpp‎ | memory‎ | unique ptr

主模板 unique_ptr<T> 的成员
void reset( pointer ptr = pointer() ) noexcept;	(1)	(constexpr since C++23)
特化 unique_ptr<T[]> 的成员
template< class U > void reset( U ptr ) noexcept;	(2)	(constexpr since C++23)
void reset( std::nullptr_t = nullptr ) noexcept;	(3)	(constexpr since C++23)

替换被管理对象。

1) 给定 *this 所管理的指针 current_ptr，进行下列行动，以此顺序：

保存当前指针的副本 old_ptr = current_ptr。
以实参覆写当前指针 current_ptr = ptr。
若旧指针非空，则删除先前管理的对象 if (old_ptr) get_deleter()(old_ptr)。

2) 表现同主模板的 reset 成员，但它仅若满足下列任意条件才参与重载决议

U 与 pointer 是同一类型，或
pointer 与 element_type* 是同一类型，且 U 为指针类型 V*，并满足 V(*)[] 可隐式转换为 element_type(*)[]。

3) 等价于 reset(pointer())。

参数

ptr

指向要管理的新对象的指针

返回值

（无）

注解

为在提供新删除器时替换被管理对象，可能使用移动赋值运算符。

不进行自重置测试，即检查 ptr 是否指向已由 *this 管理的对象，除非此测试作为编译器扩展，或调试断言提供。注意如 p.reset(p.release()) 的代码不涉及自重置，只有类似 p.reset(p.get()) 的代码才是。

示例

#include <iostream>
#include <memory>
 
struct Foo // 要管理的对象
{
    Foo() { std::cout << "Foo...\n"; }
    ~Foo() { std::cout << "~Foo...\n"; }
};
 
struct D // 删除器
{
    void operator() (Foo* p)
    {
        std::cout << "为 Foo 对象调用 delete... \n";
        delete p;
    }
};
 
int main()
{
    std::cout << "创建新的 Foo...\n";
    std::unique_ptr<Foo, D> up(new Foo(), D()); // up 占有 Foo 指针（删除器 D ）
 
    std::cout << "以新的 Foo 替换所拥有的 Foo...\n";
    up.reset(new Foo());  // 调用旧者的删除器
 
    std::cout << "释放并删除所拥有的 Foo...\n";
    up.reset(nullptr);
}

输出：

创建新的 Foo...
Foo...
以新的 Foo 替换所拥有的 Foo...
Foo...
为 Foo 对象调用 delete...
~Foo...
释放并删除所拥有的 Foo...
为 Foo 对象调用 delete...
~Foo...

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 2118	C++11	`unique_ptr<T[]>::reset` 拒绝限定转换	接受

参阅

release

返回一个指向被管理对象的指针，并释放所有权
(公开成员函数)