命名空间
变体
操作

std::inout_ptr_t<Smart,Pointer,Args...>::~inout_ptr_t

来自 cppreference.cn
< cpp‎ | memory‎ | inout ptr t
 
 
内存管理库
(仅为说明目的*)
未初始化内存算法
(C++17)
(C++17)
(C++17)
受约束的未初始化
内存算法
C 库

分配器
内存资源
垃圾回收支持
(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++20*)
显式生命周期管理
 
 
~inout_ptr_t();
(自 C++23 起)

通过修改后的 Pointer 对象的值(或者如果调用了 operator void**(),则为 void* 对象)和捕获的参数,重置适配的 Smart 对象。如果构造函数未调用 release(),则可以在适配的 Smart 对象上调用 release()

  • s 表示适配的 Smart 对象,
  • args... 表示捕获的参数,
  • p 表示存储的 Pointer 的值,或者如果调用了 operator void**,则为 static_cast<Pointer>(*operator void**())
  • SP
    • Smart::pointer,如果有效并表示类型,否则,
    • Smart::element_type*,如果 Smart::element_type 有效并表示类型,否则,
    • std::pointer_traits<Smart>::element_type*,如果 std::pointer_traits<Smart>::element_type 有效并表示类型,否则,
    • Pointer,
  • /*do-release*/ 表示 s.release() 如果 构造函数 未调用 release(),否则为空。

如果 Smart 是指针类型,则析构函数执行

s = static_cast<Smart>(p);,并且如果 sizeof...(Args) > 0,则程序是非良构的;

否则,如果 s.reset(static_cast<SP>(p), std::forward<Args>(args)...) 是良构的,则析构函数执行

/*do-release*/; if (p) { s.reset(static_cast<SP>(p), std::forward<Args>(args)...); };

否则,如果 std::is_constructible_v<Smart, SP, Args...>true,则析构函数执行

/*do-release*/; if (p) { s = Smart(static_cast<SP>(p), std::forward<Args>(args)...); };

否则,程序是非良构的。

[edit] 注意

实现可以在构造时为 Smart (例如控制块) 所需的数据结构分配存储空间,以便将非抛出工作留给析构函数。

按值捕获的参数在重置后销毁。

[edit] 缺陷报告

以下行为更改缺陷报告被追溯应用于先前发布的 C++ 标准。

DR 应用于 已发布行为 正确行为
LWG 3897 C++23 析构函数未将原始指针更新为 null 值 它会更新