std::unique_ptr

 

C++

语言

概念

实用工具库

字符串库

集装箱库

算法库

迭代器库

Numerics库

输入/输出库

本地化库

正则表达式库 （C++11）

原子操作库 （C++11）

线程的支持库 （C++11）

 

实用工具库

类型的支持 (basic types, RTTI, type traits)

动态内存管理

错误处理

程序实用工具

可变参数函数

日期和时间

函数对象

initializer_list （C++11）

bitset

hash （C++11）

关系运算符 原文： Relational operators 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

双和元组 原文： Pairs and tuples 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

pair

tuple （C++11）

piecewise_construct_t （C++11）

piecewise_construct （C++11）

掉期，远期和移动 原文： Swap, forward and move 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

swap

forward （C++11）

move （C++11）

move_if_noexcept （C++11）

declval （C++11）

 

动态内存管理

低级别的内存管理
分配器 原文： Allocators 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
allocator
allocator_traits （C++11）
allocator_arg_t （C++11）
allocator_arg （C++11）
uses_allocator （C++11）
scoped_allocator_adaptor （C++11）
未初始化的存储空间 原文： Uninitialized storage 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
uninitialized_copy
uninitialized_copy_n （C++11）
uninitialized_fill
uninitialized_fill_n
raw_storage_iterator
get_temporary_buffer
return_temporary_buffer
智能指针 原文： Smart pointers 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
unique_ptr （C++11）
shared_ptr （C++11）
weak_ptr （C++11）
auto_ptr （已弃用）
owner_less （C++11）
enable_shared_from_this （C++11）
bad_weak_ptr （C++11）
default_delete （C++11）
垃圾收集的支持 原文： Garbage collection support 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
declare_reachable （C++11）
undeclare_reachable （C++11）
declare_no_pointers （C++11）
undeclare_no_pointers （C++11）
pointer_safety （C++11）
get_pointer_safety （C++11）
杂项 原文： Miscellaneous 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
pointer_traits （C++11）
addressof （C++11）
align （C++11）
C库 原文： C Library 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
malloc calloc	realloc free

 

的std ::的unique_ptr

成员函数 原文： Member functions 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

unique_ptr::unique_ptr

unique_ptr::~unique_ptr

unique_ptr::operator=

修饰符 原文： Modifiers 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

unique_ptr::release

unique_ptr::reset

unique_ptr::swap

观察员 原文： Observers 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

unique_ptr::get

unique_ptr::get_deleter

unique_ptr::operator bool

unique_ptr::operator* unique_ptr::operator->

unique_ptr::operator[]

非成员函数 原文： Non-member functions 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

operator== operator!= operator< operator> operator<= operator> operator>=

std::swap

std::hash

 

在头文件 <memory> 中定义
template<     class T,     class Deleter = std::default_delete<T> > class unique_ptr;	(1)	（C++11 起）
template <     class T,     class Deleter > class unique_ptr<T[],Deleter>;	(2)	（C++11 起）

std::unique_ptr是一个智能指针

原文：

std::unique_ptr is a smart pointer that:

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

• 保留了唯一的一个对象的所有权通过指针

  原文：

  retains sole ownership of an object through a pointer, and

  这段文字是通过 Google Translate 自动翻译生成的。
  您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
• unique_ptr超出范围时，会破坏指向的对象.....

  原文：

  destroys the pointed-to object when the unique_ptr goes out of scope.

  这段文字是通过 Google Translate 自动翻译生成的。
  您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

unique_ptr是不能拷贝或复制，转让，无法管理的两个实例unique_ptr同一个对象。一个non-constunique_ptr的管理对象的所有权转移到另一个unique_ptr。一个const std::unique_ptr不得转让，限制的生命周期的管理对象指针的范围中。当unique_ptr被销毁，它处理的对象，通过Deleter.

原文：

unique_ptr is not copyable or copy-assignable, two instances of unique_ptr cannot manage the same object. A non-const unique_ptr can transfer the ownership of the managed object to another unique_ptr. A const std::unique_ptr cannot be transferred, limiting the lifetime of the managed object to the scope in which the pointer was created. When the unique_ptr is destroyed, it disposes of the object through Deleter.

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

有两个版本的std::unique_ptr

原文：

There are two versions of std::unique_ptr:

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

1)

管理一个单一的对象的生命周期，例如新的分配

原文：

manages the lifetime of a single object, e.g. allocated with new

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

2)

管理一个阵列的寿命与运行时间的长度，例如分配新的[]

原文：

manages the lifetime of an array with a runtime length, e.g. allocated with new[]

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

典型用途的std::unique_ptr包括

原文：

Typical uses of std::unique_ptr include

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

• 提供异常安全的类和函数来处理动态一生的对象，通过异常正常退出和退出保障缺失对.

  原文：

  providing exception safety to classes and functions that handle objects with dynamic lifetime, by guaranteeing deletion on both normal exit and exit through exception.

  这段文字是通过 Google Translate 自动翻译生成的。
  您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

• 功能通过动态一生唯一拥有的对象的所有权

  原文：

  passing ownership of uniquely-owned objects with dynamic lifetime into functions

  这段文字是通过 Google Translate 自动翻译生成的。
  您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

• 收购从功能的动态一生唯一拥有的对象的所有权

  原文：

  acquiring ownership of uniquely-owned objects with dynamic lifetime from functions

  这段文字是通过 Google Translate 自动翻译生成的。
  您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

• 作为移动感知的容器，如std::vector，动态分配的对象的指针，例如元素类型如果需要的多态行为

  原文：

  as the element type in move-aware containers, such as std::vector, which hold pointers to dynamically-allocated objects, e.g. if polymorphic behavior is desired

  这段文字是通过 Google Translate 自动翻译生成的。
  您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

会员类型

会员类型 原文： Member type 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。	Definition
pointer	std::remove_reference<D>::type::pointer如果存在该类型的，否则T * 原文： std::remove_reference<D>::type::pointer if that type exists, otherwise T* 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
element_type	T，该对象的类型的此unique_ptr管理 原文： T, the type of the object managed by this unique_ptr 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
deleter_type	Deleter，函数对象或左值引用函数或函数对象，被调用的析构函数 原文： Deleter, the function object or lvalue reference to function or to function object, to be called from the destructor 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

成员函数

(constructor)	构造一个新的unique_ptr 原文： constructs a new unique_ptr 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
(destructor)	解构的托管对象，如果存在 原文： destructs the managed object if such is present 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
operator=	分配unique_ptr 原文： assigns the unique_ptr 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
修饰符 原文： Modifiers 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
release	返回一个指针，指向被管理对象，并释放所有权 原文： returns a pointer to the managed object and releases the ownership 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
reset	取代管理的对象 原文： replaces the managed object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
swap	掉期所管理的对象 原文： swaps the managed objects 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
观察员 原文： Observers 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
get	返回一个指针，指向被管理对象 原文： returns a pointer to the managed object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
get_deleter	返回删除器，用于管理对象的破坏 原文： returns the deleter that is used for destruction of the managed object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
operator bool	检查是否有相关的管理对象 原文： checks if there is associated managed object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
单个对象版本，<T>的unique_ptr 原文： Single-object version, unique_ptr<T> 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
operator* operator->	解引用指针到的管理对象 原文： dereferences pointer to the managed object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
阵列版本的unique_ptr <T[]>的 原文： Array version, unique_ptr<T[]> 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
operator[]	提供索引访问管理的阵列 原文： provides indexed access to the managed array 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）

非成员函数

operator== operator!= operator< operator<= operator> operator>=	另一个unique_ptr比较或与nullptr 原文： compares to another unique_ptr or with nullptr 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）
std::swap(std::unique_ptr) （C++11）	专业的std::swap算法 原文： specializes the std::swap algorithm 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）

Helper类

std::hash<std::unique_ptr> （C++11）	std::unique_ptr的哈希支持 原文： hash support for std::unique_ptr 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （类模板特化）

示例

#include <iostream>
#include <memory>
 
struct Foo {
    Foo() { std::cout << "Foo::Foo\n"; }
    ~Foo() { std::cout << "Foo::~Foo\n"; }
    void bar() { std::cout << "Foo::bar\n"; }
};
 
void f(const Foo &foo)
{
    std::cout << "f(const Foo&)\n";
}
 
int main()
{
    std::unique_ptr<Foo> p1(new Foo);  // p1 owns Foo
    if (p1) p1->bar();
 
    {
        std::unique_ptr<Foo> p2(std::move(p1));  // now p2 owns Foo
        f(*p2);
 
        p1 = std::move(p2);  // ownership returns to p1
        std::cout << "destroying p2...\n";
    }
 
    if (p1) p1->bar();
 
    // Foo instance is destroyed when p1 goes out of scope
}

输出：

Foo::Foo
Foo::bar
f(const Foo&)
destroying p2...
Foo::bar
Foo::~Foo