std::unique_ptr<T,Deleter>::reset
来自 cppreference.cn
< cpp | memory | unique ptr
| unique_ptr<T> 主模板的成员 |
||
void reset( pointer ptr = pointer() ) noexcept; |
(1) | (C++23 起为 constexpr) |
| 特化 unique_ptr<T[]> 的成员 |
||
template< class U > void reset( U ptr ) noexcept; |
(2) | (C++23 起为 constexpr) |
void reset( std::nullptr_t = nullptr ) noexcept; |
(3) | (C++23 起为 constexpr) |
替换被管理的对象。
1,2) 等价于 auto old_ptr = get();
/* 将 “ptr” 赋值给存储的指针 */
if (old_ptr)
get_deleter()(old_ptr);。
/* 将 “ptr” 赋值给存储的指针 */
if (old_ptr)
get_deleter()(old_ptr);。
如果 get_deleter()(old_ptr) 抛出异常，则行为未定义。
2) 此重载仅当
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 // object to manage { Foo() { std::cout << "Foo...\n"; } ~Foo() { std::cout << "~Foo...\n"; } }; struct D // deleter { 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 owns the Foo pointer (deleter D) std::cout << "Replace owned Foo with a new Foo...\n"; up.reset(new Foo()); // calls deleter for the old one 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...
[编辑] 缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 发布时的行为 | 正确的行为 |
|---|---|---|---|
| LWG 2118 | C++11 | unique_ptr<T[]>::reset 拒绝限定转换 |
接受 |
| LWG 2169 | C++11 | 重载 unique_ptr<T[]>::reset(pointer) 存在 |
移除重载 |
[编辑] 参阅
| 返回指向托管对象的指针并释放所有权 (public 成员函数) |
