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

 

C++

编译器支持

独立式和宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

内存管理库

voidify (仅为阐释*) 未初始化内存算法 uninitialized_copy uninitialized_fill uninitialized_move (C++17) uninitialized_default_construct (C++17) uninitialized_value_construct (C++17) destroy (C++17) destroy_at (C++17) uninitialized_copy_n (C++11) uninitialized_fill_n uninitialized_move_n (C++17) uninitialized_default_construct_n (C++17) uninitialized_value_construct_n (C++17) destroy_n (C++17) construct_at (C++20) 受约束的未初始化 内存算法 ranges::uninitialized_copy (C++20) ranges::uninitialized_fill (C++20) ranges::uninitialized_move (C++20) ranges::construct_at (C++20) ranges::destroy (C++20) ranges::destroy_n (C++20) ranges::destroy_at (C++20) ranges::uninitialized_copy_n (C++20) ranges::uninitialized_fill_n (C++20) ranges::uninitialized_move_n (C++20) ranges::uninitialized_default_construct (C++20) ranges::uninitialized_value_construct (C++20) ranges::uninitialized_default_construct_n (C++20)  ranges::uninitialized_value_construct_n (C++20) C 库 malloc calloc realloc aligned_alloc (C++17) free

分配器 allocator allocator_traits (C++11) allocation_result (C++23) allocator_arg (C++11) uses_allocator (C++11) uses_allocator_construction_args (C++20) make_obj_using_allocator (C++20) uninitialized_construct_using_allocator (C++20)  scoped_allocator_adaptor (C++11) pmr::polymorphic_allocator (C++17) 内存资源 pmr::memory_resource (C++17) pmr::get_default_resource (C++17) pmr::set_default_resource (C++17) pmr::new_delete_resource (C++17) pmr::null_memory_resource (C++17) pmr::synchronized_pool_resource (C++17) pmr::unsynchronized_pool_resource (C++17) pmr::monotonic_buffer_resource (C++17) pmr::pool_options (C++17) 垃圾回收支持 declare_reachable (C++11)(until C++23) undeclare_reachable (C++11)(until C++23) declare_no_pointers (C++11)(until C++23) undeclare_no_pointers (C++11)(until C++23) pointer_safety (C++11)(until C++23) get_pointer_safety (C++11)(until C++23) 未初始化存储 raw_storage_iterator (until C++20*) get_temporary_buffer (until C++20*) return_temporary_buffer (until C++20*) 显式生命周期管理 start_lifetime_asstart_lifetime_as_array (C++23)(C++23)

智能指针 unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (until C++17*) owner_less (C++11) owner_less<void> (C++17) owner_hash (C++26) owner_equal (C++26) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) out_ptr_t (C++23) inout_ptr_t (C++23) 底层内存 管理 operator new operator new[] operator delete operator delete[] get_new_handler (C++11) set_new_handler launder (C++17) bad_alloc bad_array_new_length (C++11) nothrow_t align_val_t (C++17) destroying_delete_t (C++20) new_handler nothrow 杂项 pointer_traits (C++11) to_address (C++20) addressof (C++11) align (C++11) assume_aligned (C++20) is_sufficiently_aligned (C++26)

 

std::out_ptr_t

成员函数

out_ptr_t::out_ptr_t

out_ptr_t::~out_ptr_t

out_ptr_t::operator Pointer*out_ptr_t::operator void**

非成员函数

out_ptr

 

operator Pointer*() const noexcept;	(1)	(since C++23)
operator void**() const noexcept;	(2)	(since C++23)

向外部函数公开 Pointer 或 void* 对象的地址，外部函数通常会重新初始化它。

1) 将 *this 转换为存储的 Pointer 对象的地址。

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

一旦在 out_ptr_t 对象上调用了这两个转换函数中的一个，则不得再对其调用另一个，否则行为是未定义的。

参数

（无）

返回值

1) 存储的 Pointer 对象的地址。

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

注解

如果返回值指向的对象尚未被重写，则它等于 nullptr。

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

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

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