std::inout_ptr_t(C++23)

namespace std {
  template<class Smart, class Pointer, class... Args>
  class inout_ptr_t;
}

概要

2重ポインタT**(=Pointer*)引数経由で既存リソースを解放してから新規確保リソースへのポインタを返すレガシーC関数に対して、取得されたポインタ値をスマートポインタに格納するアダプタクラス。アダプタオブジェクトの生成には、std::inout_ptr()ヘルパ関数を利用する。

リソース占有管理セマンティクスを提供するC++標準スマートポインタstd::unique_ptrを始め、互換インタフェースをもつ任意のスマートポインタ型Smartを取り扱える。

プログラマはinout_ptr_tクラステンプレートの特殊化を定義してもよい。このとき1つ以上のプログラム定義型に依存していれば、プライマリテンプレートにおける要件を満たす必要はない。

PointerはCpp17NullablePointer要件を満たすこと

Smartがshared_ptrの特殊化の場合、プログラムは不適格となる。