命名空间
变体
操作

std::inout_ptr_t<Smart,Pointer,Args...>::operator Pointer*, std::inout_ptr_t<Smart,Pointer,Args...>::operator void**

来自 cppreference.cn
< cpp‎ | 内存‎ | 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*)
显式生命周期管理
 
std::inout_ptr_t
成员函数
inout_ptr_t::operator Pointer*inout_ptr_t::operator void**
非成员函数
 
operator Pointer*() const noexcept;
(1) (C++23 起)
operator void**() const noexcept;
(2) (C++23 起)

Pointervoid* 对象的地址暴露给外部函数,该函数通常会释放其值表示的所有权,然后重新初始化它。

1)*this 转换为存储的 Pointer 对象的地址。
2)*this 转换为 void* 对象的地址。此转换函数仅当 Pointervoid* 不同时才参与重载决议,并且如果 Pointer 不是指针类型,则程序格式错误。
void* 对象的初始值等于存储的 Pointer 对象转换为 void* 的值,对其的任何修改都会影响 析构函数 中使用的 Pointer 值。在 *this 的生命周期之外访问 void* 对象具有未定义行为。

一旦在 inout_ptr_t 对象上调用了这两个转换函数中的一个,就不应再调用另一个,否则行为未定义。

目录

[编辑] 参数

(无)

[编辑] 返回值

1) 存储的 Pointer 对象的地址。
2) 满足上述要求的 void* 对象的地址。

[编辑] 注意

如果返回值指向的对象未被重写,则它等于构造前由适应的 Smart 对象持有的值。

在常见的实现中,作为指针类型的每个 Pointer 的对象表示都与 void* 兼容,因此这些实现通常将 void* 对象存储在 Pointer 对象的存储空间中,不需要额外的存储空间。

  • 如果实现启用了基于类型的别名分析(依赖于严格别名规则),则可以使用一个对齐良好的 std::byte[sizeof(void*)] 成员子对象,并且这两个转换函数都返回数组中隐式创建的对象的地址。
  • 否则,两个转换函数都可以使用 Pointer 成员子对象,并且 (2) 可以直接将其地址 reinterpret_castvoid**

如果 Pointer 是一种指针类型,其对象表示与 void* 不兼容,则可能需要一个额外的 bool 标志来记录是否已调用 (1)(或 (2))。

[编辑] 示例