std::unique_ptr.reset

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

C++

工具库

动态内存管理

std::unique_ptr

 

初等模板 unique_ptr<T> 的成员
void reset( pointer ptr = pointer() ) noexcept;	(1)
特化 unique_ptr<T[]> 的成员
void reset( pointer ptr = pointer() ) noexcept;	(2)	(C++17 前)
	(3)
template< class U >  void reset( U ) = delete;		(C++17 前)
template< class U >  void reset( U ) noexcept;		(C++17 起)
		(4)
void reset( std::nullptr_t p ) noexcept;			(C++17 前)
void reset( std::nullptr_t p = nullptr ) noexcept;			(C++17 起)

替换被管理对象。

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

1. 保存当前指针的副本 old_ptr = current_ptr
2. 以参数重写当前指针 current_ptr = ptr
3. 若旧指针非空，则删除先前管理的对象 if(old_ptr != nullptr) get_deleter()(old_ptr) 。

2) 表现同初等模板的 reset 成员。 3) 动态数组的特化 std::unique_ptr<T[]> 中，提供此模板成员以阻止以指向导出类的指针使用 reset() （这会对数组导致未定义行为）。 4) 动态数组的特化 std::unique_ptr<T[]> 中，需要此重载以允许重置到 nullptr （否则这会为模板重载所禁止）。等价于 reset(pointer()) 。	(C++17 前)
3) 表现同初等模板的 reset 成员，除了它仅若满足下列任意条件才参与重载决议 U 与 pointer 是同一类型，或 pointer 与 element_type* 是同一类型，且 U 为指针类型 V* ，并满足 V(*)[] 可隐式转换为 element_type(*)[] 。 4) 等价于 reset(pointer()) 。	(C++17 起)

参数

ptr

-

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

返回值

（无）

注意

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

不进行自 reset 测试，即 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 << "Calling delete for Foo object... \n";
        delete p;
    }
};
 
int main()
{
    std::cout << "Creating new Foo...\n";
    std::unique_ptr<Foo, D> up(new Foo(), D());  // up 占有 Foo 指针（删除器 D ）
 
    std::cout << "Replace owned Foo with a new Foo...\n";
    up.reset(new Foo());  // 调用旧者的删除器
 
    std::cout << "Release and delete the owned Foo...\n";
    up.reset(nullptr);      
}

输出：

Creating new Foo...
Foo...
Replace owned Foo with a new Foo...
Foo...
Calling delete for Foo object...
~Foo...
Release and delete the owned Foo...
Calling delete for Foo object...
~Foo...

参阅

release

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