std:: out_ptr_t

out_ptr_t 用于适配诸如智能指针等类型，以适用于通过 Pointer* （通常为某种对象类型 T 的 T** ）或 void ** 参数输出结果的外部函数。

out_ptr_t 在构造时捕获额外参数，为前述外部函数写入的结果提供存储空间，并在其销毁时使用结果及捕获的参数重置被适配的 Smart 对象。

out_ptr_t 的行为表现如同持有以下非静态数据成员：

• 一个 Smart& 引用，在构造时绑定到被适配对象，
• 对于 Args... 中的每个 T ，都有一个类型为 T 的成员，该成员在构造时捕获参数并在销毁时用于重置操作，以及
• 一个适合存储 Pointer 并提供 void * 对象的成员子对象，其中 Pointer 或 void * 对象通常暴露给外部函数用于重新初始化。

用户可以通过在 Args... 中分别指定对象类型或引用类型，来控制每个重置参数是按值捕获还是按引用捕获。

模板参数

特化

与标准库中的大多数类模板不同， out_ptr_t 的 程序定义特化 若依赖于至少一个 程序定义类型 ，则无需满足主模板的要求。

此许可证允许程序定义的专门化将存储在非标准智能指针内的原始指针暴露给外部函数。

成员函数

非成员函数

注释

out_ptr_t 预期外部函数不会使用指向的 Pointer 的值，仅会重新初始化它。适配前智能指针的值不会被使用。

out_ptr_t 的典型用法是通过 std::out_ptr 创建其临时对象，这会立即重置被适配的智能指针。例如，给定一个设置函数和相应类型的智能指针，分别声明为 int foreign_setter ( T ** ) ; 和 std:: unique_ptr < T, D > up ; ，

int foreign_setter(T**);
std::unique_ptr<T, D> up;
if (int ec = foreign_setter(std::out_ptr(up)))
    return ec;

大致相当于

int foreign_setter(T**);
std::unique_ptr<T, D> up;
T* raw_p{};
int ec = foreign_setter(&raw_p);
up.reset(raw_p);
if (ec != 0)
    return ec;

不建议创建具有除 自动存储期 之外存储期的 out_ptr_t 对象，因为此类代码很可能产生悬空引用并在析构时导致未定义行为。

out_ptr_t 禁止在未指定删除器的情况下重置 std::shared_ptr 的用法，因为这会调用 std::shared_ptr::reset 并在后续替换自定义删除器。

捕获的参数通常被打包到 std:: tuple < Args... > 中。实现可能采用不同机制来提供它们需要持有的 Pointer 或 void * 对象。

示例

参见