std::experimental::unique_resource
来自cppreference.com
< cpp | experimental
|
在标头
<experimental/scope>
定义
|
||
|
template<class
R, class
D>
class unique_resource; |
(库基础 TS v3) | |
unique_resource 是通用的资源柄 RAII 包装，通过柄占有并管理资源，并在
unique_resource 销毁时释放该资源。
在以下任一情况发生时，用 D 类型删除器释放资源：
- 销毁管理的
unique_resource对象 - 经由 operator= 或 reset() 赋另一资源给
unique_resource对象。
若 R 为对象类型则令 RS 为 R ，否则为 std::reference_wrapper<std::remove_reference_t<R>> ：
-
unique_resource等效地保有包装或作为资源柄的RS类型子对象、D类型删除器及指示包装是否占有资源的 bool 标志。 - 为解释目的，称
RS为存储的资源柄，存储（若R为对象类型）或包装（若R为引用类型）的R为底层资源柄。 LFTS 不使用此二用语。
模板形参
| R | - | 资源柄类型 |
| D | - | 删除器类型 |
| 类型要求 | ||
-R
应当为对象类型或到对象的左值引用类型。令 UnrefR 为 std::remove_reference_t<R>
，则 UnrefR 应当为可移动构造
(MoveConstructible)
，而若 UnrefR 非可复制构造
(CopyConstructible)
，则 std::is_nothrow_move_constructible_v<UnrefR>
应当为 true
。
|
||
-D 应当为可析构
(Destructible)
且可移动构造
(MoveConstructible)
的函数对象
(FunctionObject)
类型，而若 D 非可复制构造
(CopyConstructible)
，则 std::is_nothrow_move_constructible_v<R>
应当为 true
。 给定 D 类型左值 d 与
UnrefR 类型左值 r ，表达式 d(r)
应当为良构。
|
||
成员函数
构造新的 unique_resource (公开成员函数) |
|
| 释放被管理资源，若它存在 (公开成员函数) |
|
赋值 unique_resource (公开成员函数) |
|
修改器 |
|
| 放弃所有权 (公开成员函数) |
|
| 释放或替换被管理的资源 (公开成员函数) |
|
观察器 |
|
| 访问底层资源柄 (公开成员函数) |
|
| 访问用于释放被管理资源的删除器 (公开成员函数) |
|
| 访问被指向者，若资源柄为指针 (公开成员函数) |
|
非成员函数
创建 unique_resource ，检查非法值 (函数模板) |
推导指引
注解
满足可空指针 (NullablePointer)
的资源柄类型亦能由 std::unique_ptr
管理。不同于 unique_ptr ， unique_resource 不要求可空指针 (NullablePointer)
。
示例
| 本节未完成 原因：暂无示例 |
参阅
|
(C++11)
|
拥有独有对象所有权语义的智能指针 (类模板) |