命名空间
变体
操作

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

来自 cppreference.cn
< 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.cn/mwiki/index.php?title=cpp/memory/unique_ptr/release&oldid=152335"