std::out_ptr

来自cppreference.com
< cpp‎ | memory‎ | out ptr t
 
C++
 
工具库
语言支持
类型支持（基本类型、RTTI）
库功能特性测试宏 (C++20)
动态内存管理
程序工具
协程支持 (C++20)
变参数函数
(C++20)
(C++26)
(C++11)
(C++20)
调试支持
(C++26)
(C++26)
(C++26)
三路比较
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)   
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换与类型运算
(C++20)
(C++14)
(C++11)
(C++23)
(C++11)
(C++23)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++11)
(C++17)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)
(C++17)

 
动态内存管理
未初始化内存算法
受约束的未初始化内存算法
分配器
垃圾收集器支持
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)



 
std::out_ptr_t
 
在标头 <memory> 定义
template< class Pointer = void, class Smart, class... Args >
auto out_ptr( Smart& s, Args&&... args );
 (C++23 起)

返回拥有被推导模板实参的 std::out_ptr_t，按引用绑定重设用的实参。

若返回值（见后述）的构造非良构则程序非良构。

参数

s - 要适配的对象（常为智能指针）
args... - 要捕获的用于重设的实参

返回值

std::out_ptr_t<Smart, P, Args&&>(s, std::forward<Args>(args)...)，其中 P 为

  • Pointer，若 Pointer 与 void 不同，
  • 否则为 Smart::pointer，若它合法并指代类型，
  • 否则为 Smart::element_type*，若 Smart::element_type 合法并指代类型，
  • 否则为 std::pointer_traits<Smart>::element_type*。

注解

用户可对模板形参 Pointer 指定模板实参，以与接收 Pointer* 的外来函数交互。

由于所有实参都按引用捕获，返回的 out_ptr_t 应为在含有外来函数调用的全表达式结尾销毁的临时对象，以避免悬垂引用。

功能特性测试宏 值 标准 功能特性
__cpp_lib_out_ptr 202106L (C++23) std::out_ptr, std::inout_ptr
202311L (C++26) 独立的 std::out_ptr 和 std::inout_ptr

示例

使用 std::out_ptr 适配一个用于 sqlite3_open 的智能指针，它预期一个 sqlite3** 作为其输出形参。

运行此代码
#include <memory>
#include <sqlite3.h>
 
int main()
{
    auto close_db = [](sqlite3* db) { sqlite3_close(db); };
 
    {
        // 打开一个内存数据库，并以一个 std::unique_ptr 管理其生存期
        std::unique_ptr<sqlite3, decltype(close_db)> up;
        sqlite3_open(":memory:", std::out_ptr(up));
 
        sqlite3* db = up.get();
        // 用 db 做些工作 ...
    }
    {
        // 同上，但使用 std::shared_ptr
        std::shared_ptr<sqlite3> sp;
        sqlite3_open(":memory:", std::out_ptr(sp, close_db));
 
        sqlite3* db = sp.get();
        // 用 db 做些工作 ...
    }
}

参阅

(C++23)
 以关联的智能指针和重设参数创建 inout_ptr_t
(函数模板)
(C++14)(C++20)
 创建管理一个新对象的独占指针
(函数模板)
(C++20)
 创建管理一个新对象的共享指针
(函数模板)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/memory/out_ptr_t/out_ptr&oldid=86583”