std:: out_ptr

リセットのための引数を参照によってキャプチャする、推定されたテンプレート引数を持つ std::out_ptr_t を返します。

戻り値（下記参照）の構築が不適格である場合、プログラムは不適格です。

パラメータ

戻り値

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 は、フルエクスプレッションの終了時に破棄される一時オブジェクトであるべきです。これにより、ダングリング参照を回避するために、外部関数呼び出しを含むフルエクスプレッション内で適切に管理されます。

例

#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を使用して何か処理を実行...
    }
}

関連項目