std::unique_ptr<T,Deleter>::reset
来自cppreference.com
< 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 // 要管理的对象{ 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 拒绝限定性转换 | 接受 |
| LWG 2169 | C++11 | 存在重载 unique_ptr<T[]>::reset(pointer) | 移除该重载 |
[编辑]参阅
| 返回一个指向被管理对象的指针，并释放所有权 (公开成员函数) |
