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

来自cppreference.com
< cpp‎ | memory‎ | unique ptr
 
 
工具库
通用工具
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)

初等字符串转换
(C++17)
(C++17)
栈踪
 
动态内存管理
智能指针
(C++11)
(C++11)
(C++11)
(C++17 前)
(C++11)
(C++23)
分配器
内存资源
未初始化存储
未初始化内存算法
受约束的未初始化内存算法
垃圾收集支持
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
杂项
(C++20)
(C++11)
(C++11)
C 库
低层内存管理
 
 
主模板 unique_ptr<T> 的成员
void reset( pointer ptr = pointer() ) noexcept;
(1)
特化 unique_ptr<T[]> 的成员
template< class U >
void reset( U ) noexcept;
(2)
void reset( std::nullptr_t p = nullptr ) noexcept;
(3)

替换被管理对象。

1) 给定指向 *this 所管理对象的指针 current_ptr ,进行下列行动,以此顺序:
  1. 保存当前指针的副本 old_ptr = current_ptr
  2. 以参数重写当前指针 current_ptr = ptr
  3. 若旧指针非空,则删除先前管理的对象 if(old_ptr != nullptr) get_deleter()(old_ptr)
2) 表现同主模板的 reset 成员,除了它仅若满足下列任意条件才参与重载决议
  1. Upointer 是同一类型,或
  2. pointerelement_type* 是同一类型,且 U 为指针类型 V* ,并满足 V(*)[] 可隐式转换为 element_type(*)[]
3) 等价于 reset(pointer())

参数

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...

缺陷报告

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

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

参阅

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