定义于头文件 <memory>
template< class T, class Deleter = std::default_delete<T>>
class unique_ptr; (1) (C++11 起)
template < class T,class Deleter>
class unique_ptr<T[], Deleter>; (2) (C++11 起)
返回一个指向被管理对象的指针，并释放所有权
std::unique_ptr<T,Deleter>::release
pointer release() noexcept; (C++11 起)
若存在，则释放被管理对象的所有权。调用后 get() 返回 nullptr 。
参数
（无）
返回值
指向被管理对象的指针，或若无被管理对象则为 nullptr ，即调用前 get() 会返回的值。
调用示例
#include <memory>
#include <iostream>
#include <cassert>
struct Foo
{
Foo()
{
std::cout << "Foo\n";
}
~Foo()
{
std::cout << "~Foo\n";
}
};
int main()
{
std::cout << "Creating new Foo...\n";
std::unique_ptr<Foo> up(new Foo());
std::cout << "About to release Foo...\n";
Foo* fp = up.release();
assert(up.get() == nullptr);
std::cout << "Foo is no longer owned by unique_ptr...\n";
delete fp;
}
输出
替换被管理对象
std::unique_ptr<T,Deleter>::reset
初等模板 unique_ptr<T> 的成员
void reset( pointer ptr = pointer() ) noexcept; (1)
特化 unique_ptr<T[]> 的成员
void reset( pointer ptr = pointer() ) noexcept; (2) (C++17 前)
template< class U > void reset( U ) = delete; （3）(C++17 前)
template< class U >void reset( U ) noexcept; （3）(C++17 起)
void reset( std::nullptr_t p ) noexcept; （4）(C++17 前)
void reset( std::nullptr_t p = nullptr ) noexcept; (C++17 起)
替换被管理对象。
1) 给定指向
*this
所管理对象的指针
current_ptr
，进行下列行动，以此顺序：
- 保存当前指针的副本 old_ptr = current_ptr
- 以参数重写当前指针 current_ptr = ptr
- 若旧指针非空，则删除先前管理的对象 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 成员，除了它仅若满足下列任意条件才参与重载决议
| (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);
}
输出
#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);
}
输出
交换被管理对象
std::unique_ptr<T,Deleter>::swap
void swap(unique_ptr& other) noexcept; (C++11 起)
交换
*this
和另一 unique_ptr 对象
other
的被管理对象和关联的删除器。
参数
| other | - | 要与之交换被管理对象和删除器的另一 unique_ptr 对象 |
返回值
（无）
调用示例
#include <iostream>
#include <memory>
struct Foo
{
Foo(int _val) : val(_val)
{
std::cout << "Foo...\n";
}
~Foo()
{
std::cout << "~Foo...\n";
}
int val;
};
int main()
{
std::unique_ptr<Foo> up1(new Foo(1));
std::unique_ptr<Foo> up2(new Foo(2));
up1.swap(up2);
std::cout << "up1->val:" << up1->val << std::endl;
std::cout << "up2->val:" << up2->val << std::endl;
}
输出