std::shared_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::shared_ptr

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

shared_ptr::shared_ptr

shared_ptr::~shared_ptr

shared_ptr::operator=

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

shared_ptr::reset

shared_ptr::swap

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

shared_ptr::get

shared_ptr::operator* shared_ptr::operator->

shared_ptr::use_count

shared_ptr::unique

shared_ptr::operator bool

shared_ptr::owner_before

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

std::swap

make_shared

allocate_shared

static_pointer_cast dynamic_pointer_cast const_pointer_cast

get_deleter

operator== operator|= operator< operator<= operator> operator>=

operator<<

atomic_is_lock_free atomic_load atomic_load_explicit atomic_store atomic_store_explicit atomic_exchange atomic_exchange_explicit atomic_compare_exchange_weak atomic_compare_exchange_strong atomic_compare_exchange_weak_explicit atomic_compare_exchange_strong_explicit

std::hash

 

在头文件 <memory> 中定义
template< class T > class shared_ptr;		（C++11 起）

std::shared_ptr 是通过指针保持某个对象的共享拥有权的智能指针。若干个 shared_ptr 对象可以拥有同一个对象；最后一个指向该对象的 shared_ptr 被销毁或重置时，该对象被销毁。销毁该对象时使用的是 delete 表达式或者是在构造 shared_ptr 时传入的自定义删除器（deleter）。

shared_ptr 也可以不拥有对象，称作空（empty）。

shared_ptr 满足 CopyConstructible 和 CopyAssignable 的要求。

成员类型

成员类型	定义
element_type	T

成员函数

(constructor)	constructs new shared_ptr （公共成员函数）
(destructor)	解构拥有的对象如果没有更多shared_ptrs的的链接 原文： destructs the owned object if no more shared_ptrs link to it 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
operator=	分配shared_ptr 原文： assigns the shared_ptr 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
修饰符 原文： Modifiers 这段文字是通过 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 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
operator* operator->	解引用指针到的管理对象 原文： dereferences pointer to the managed object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
use_count	返回shared_ptr对象指的是在同一个管理对象的数量 原文： returns the number of shared_ptr objects referring to the same managed object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
unique	检查是否被管理对象的管理仅由当前shared_ptr的实例 原文： checks whether the managed object is managed only by the current shared_ptr instance 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
operator bool	检查是否有相关的管理对象 原文： checks if there is associated managed object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）
owner_before	业主基于订购的共享指针 原文： provides owner-based ordering of shared pointers 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （公共成员函数）

非成员函数

make_shared	创建一个共享管理一个新的对象的指针，该指针 原文： creates a shared pointer that manages a new object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）
allocate_shared	创建一个共享指针管理使用分配器分配一个新的对象 原文： creates a shared pointer that manages a new object allocated using an allocator 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）
static_pointer_cast dynamic_pointer_cast const_pointer_cast	适用于static_cast，dynamic_cast或const_cast被管理对象的类型 原文： applies static_cast, dynamic_cast or const_cast to the type of the managed object 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）
get_deleter	返回指定类型的删除，如果拥有 原文： returns the deleter of specified type, if owned 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）
operator== operator!= operator< operator<= operator> operator>=	与另一个shared_ptr或nullptr 原文： compares with another shared_ptr or with nullptr 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）
operator<<	托管指针的值输出到输出流中 原文： outputs the value of the managed pointer to an output stream 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）
std::swap(std::shared_ptr) （C++11）	专业的std::swap算法 原文： specializes the std::swap algorithm 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）

std::atomic_is_lock_free(std::shared_ptr) std::atomic_load(std::shared_ptr) std::atomic_load_explicit(std::shared_ptr) std::atomic_store(std::shared_ptr) std::atomic_store_explicit(std::shared_ptr) std::atomic_exchange(std::shared_ptr) std::atomic_exchange_explicit(std::shared_ptr) std::atomic_compare_exchange_weak(std::shared_ptr) std::atomic_compare_exchange_strong(std::shared_ptr) std::atomic_compare_exchange_weak_explicit(std::shared_ptr) std::atomic_compare_exchange_strong_explicit(std::shared_ptr)

专业原子操作 原文： specializes atomic operations 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）

Helper类

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

实现说明

在典型的实现中，std::shared_ptr 只保存两个指针：

• 指向被管理对象的指针
• 指向控制块（control block）的指针

控制块是一个动态分配的对象，其中包含：

• 指向被管理对象的指针或被管理对象本身
• 删除器
• 分配器（allocator）
• 拥有被管理对象的 shared_ptr 的数量
• 引用被管理对象的 weak_ptr 的数量

通过 std::make_shared 和 std::allocate_shared 创建 shared_ptr 时，控制块将被管理对象本身作为其数据成员；而通过构造函数创建 shared_ptr 时则保存指针。

shared_ptr 持有的指针是通过 get() 返回的；而控制块所持有的指针/对象则是最终引用计数归零时会被删除的那个。两者并不一定相等。

shared_ptr 的析构函数会将控制块中的 shared_ptr 计数器减一，如果减至零，控制块就会调用被管理对象的析构函数。但控制块本身直到 std::weak_ptr 计数器同样归零时才会释放。