std::unique_ptr<T,Deleter>::reset
来自cppreference.com
< 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 拒绝限定转换
|
接受 |
参阅
| 返回一个指向被管理对象的指针，并释放所有权 (公开成员函数) |