std::unique_ptr<T,Deleter>:: release

管理されているオブジェクトの所有権がある場合、それを解放します。

get() 呼び出し後に nullptr を返します。

呼び出し側はオブジェクトのクリーンアップ責任を負います（例： get_deleter() の使用による）。

パラメータ

(なし)

戻り値

管理対象オブジェクトへのポインタ、または管理対象オブジェクトが存在しない場合（つまり、呼び出し前に get() によって返される値）は nullptr です。

例

#include <cassert>
#include <iostream>
#include <memory>
struct Foo
{
    Foo() { std::cout << "Foo\n"; }
    ~Foo() { std::cout << "~Foo\n"; }
};
// Fooリソースの所有権はこの関数呼び出し時に移譲される
void legacy_api(Foo* owning_foo)
{
    std::cout << __func__ << '\n';
    // [誰も理解せず、触れることを恐れるレガシーコード]
    // [...]
    delete owning_foo;
}
int main()
{
    std::unique_ptr<Foo> managed_foo(new Foo);
    // [returnしたり例外を投げたりする可能性のあるコード]
    // [...]
    legacy_api(managed_foo.release());
    assert(managed_foo == nullptr);
}

Foo
legacy_api
~Foo

関連項目