名稱空間
變體
操作

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

來自 cppreference.com
< cpp‎ | memory‎ | unique ptr
 
C++
 
記憶體管理庫
(僅作說明*)
未初始化記憶體演算法
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(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 庫

分配器
(C++11)
(C++23)
(C++11)
(C++11)
(C++20)
(C++20)
(C++20) 
(C++11)
(C++17)
記憶體資源
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(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)
未初始化儲存
(直到 C++20*)
(直到 C++20*)
(直到 C++20*)
顯式生命週期管理
(C++23)(C++23)
 
std::unique_ptr
 
pointer release() noexcept;
 (C++11 起)
(C++23 起為 constexpr)

釋放所管理物件的所有權（如果有）。

呼叫後，get() 返回 nullptr。

呼叫者負責清理物件（例如，透過使用 get_deleter()）。

目錄

[編輯] 引數

(無)

[編輯] 返回值

指向被管理物件的指標，如果沒有被管理物件則為 nullptr，即呼叫前 get() 將返回的值。

[編輯] 示例

執行此程式碼
#include <cassert>
#include <iostream>
#include <memory>
 
struct Foo
{
    Foo() { std::cout << "Foo\n"; }
    ~Foo() { std::cout << "~Foo\n"; }
};
 
// Ownership of the Foo resource is transferred when calling this function
void legacy_api(Foo* owning_foo)
{
    std::cout << __func__ << '\n';
    // [legacy code that no one understands or dares touch anymore]
    // [...]
    delete owning_foo;
}
 
int main()
{
    std::unique_ptr<Foo> managed_foo(new Foo);
    // [code that might return or throw or some such]
    // [...]
    legacy_api(managed_foo.release());
 
    assert(managed_foo == nullptr);
}

輸出

Foo
legacy_api
~Foo

[編輯] 參閱

 返回指向託管物件的指標
(public member function) [編輯]
 返回用於銷燬託管物件的刪除器
(public member function) [編輯]
 替換託管物件
(public member function) [編輯]
取自 "https://cppreference.tw/mwiki/index.php?title=cpp/memory/unique_ptr/release&oldid=152335"