std::atomic_...<std::shared_ptr>

来自cppreference.com
< cpp‎ | memory‎ | shared ptr
 
 
工具库
类型支持(基本类型、 RTTI 、类型特性)
动态内存管理
错误处理
程序工具
变参数函数
日期和时间
函数对象
(C++11)
关系运算符
optionalanyvariant (C++17)
pair 与 tuple
(C++11)
(C++17)
swap 、 forward 与 move
(C++14)
(C++11)
(C++11)
初等字符串转换
(C++17)
(C++17)
类型运算
(C++11)
(C++17)
 
 
std::shared_ptr
成员函数
修改器
观察器
非成员函数
atomic_is_lock_freeatomic_loadatomic_load_explicitatomic_storeatomic_store_explicitatomic_exchangeatomic_exchange_explicitatomic_compare_exchange_weakatomic_compare_exchange_strongatomic_compare_exchange_weak_explicitatomic_compare_exchange_strong_explicit
推导指引(C++17)
 
template< class T >
bool atomic_is_lock_free( const std::shared_ptr<T>* p );
(1) (C++11 起)
template< class T >
std::shared_ptr<T> atomic_load( const std::shared_ptr<T>* p );
(2) (C++11 起)
template< class T >

std::shared_ptr<T> atomic_load_explicit( const std::shared_ptr<T>* p,

                                         std::memory_order mo );
(3) (C++11 起)
template< class T >

void atomic_store( std::shared_ptr<T>* p,

                   std::shared_ptr<T> r );
(4) (C++11 起)
template< class T >

void atomic_store_explicit( std::shared_ptr<T>* p,
                            std::shared_ptr<T> r,

                            std::memory_order mo);
(5) (C++11 起)
template< class T >

std::shared_ptr<T> atomic_exchange( std::shared_ptr<T>* p,

                                    std::shared_ptr<T> r);
(6) (C++11 起)
template<class T>

std::shared_ptr<T> atomic_exchange_explicit( std::shared_ptr<T>* p,
                                             std::shared_ptr<T> r,

                                             std::memory_order mo);
(7) (C++11 起)
template< class T >

bool atomic_compare_exchange_weak( std::shared_ptr<T>* p,
                                   std::shared_ptr<T>* expected,

                                   std::shared_ptr<T> desired);
(8) (C++11 起)
template<class T>

bool atomic_compare_exchange_strong( std::shared_ptr<T>* p,
                                     std::shared_ptr<T>* expected,

                                     std::shared_ptr<T> desired);
(9) (C++11 起)
template< class T >

bool atomic_compare_exchange_strong_explicit( std::shared_ptr<T>* p,
                                              std::shared_ptr<T>* expected,
                                              std::shared_ptr<T> desired,
                                              std::memory_order success,

                                              std::memory_order failure);
(10) (C++11 起)
template< class T >

bool atomic_compare_exchange_weak_explicit( std::shared_ptr<T>* p,
                                            std::shared_ptr<T>* expected,
                                            std::shared_ptr<T> desired,
                                            std::memory_order success,

                                            std::memory_order failure);
(11) (C++11 起)

若多个执行线程访问同一 std::shared_ptr 对象而无同步,且这些访问中任一者使用 shared_ptr 的非 const 成员函数,则发生数据竞争,除非所有这种访问都通过这些作为对应原子访问函数( std::atomic_loadstd::atomic_store 等)重载的函数进行。

注意 shared_ptr 的控制块是线程安全的:多个线程能同时用可改操作访问不同的 std::shared_ptr 对象,如 operator= 或 reset ,即使这些实例是副本,并内部共享同一控制块。

1) 确定到 p 所指向共享指针的原子访问是否无锁。
2) 等价于 atomic_load_explicit(p, std::memory_order_seq_cst)
3) 返回 p 所指向的共享指针。同非特化的 std::atomic_load_explicitmo 不能是 std::memory_order_releasestd::memory_order_acq_rel
4) 等价于 atomic_store_explicit(p, r, memory_order_seq_cst)
5) 原子地存储共享指针 rp 所指向的共享指针,等效地执行 p->swap(r) 。同非特化的 std::atomic_store_explicitmo 不能是 std::memory_order_acquirestd::memory_order_acq_rel
6) 等价于 atomic_exchange_explicit(p, r, memory_order_seq_cst)
7) 原子地存储共享指针 rp 所指向的共享指针,并返回 p 先前指向的值。等效地执行 p->swap(r) 并返回交换后 r 的副本。
8) 等价于 atomic_compare_exchange_weak_explicit(p, expected, desired, std::memory_order_seq_cst, std::memory_order_seq_cst)
9) 等价于 atomic_compare_exchange_strong_explicit(p, expected, desired, std::memory_order_seq_cst, std::memory_order_seq_cst)
10) 比较 p 所指向的共享指针和 expected 。若它们等价(共享同一指针的所有权并指代同一指针),则用 success 所指定的内存定序制约赋值 desired*p 并返回 true 。若它们不等价,则用 failure 所指定的内存定序制约赋值 *p*expected 并返回 false
11) 同 10) ,但可能虚假地失败。

p 为空指针则这些函数都会引发未定义行为。

目录

[编辑] 参数

p, expected - 指向 std::shared_ptr 的指针
r, desired - 一个 std::shared_ptr
mo, success, failure - std::memory_order 类型的内存定序选择器

[编辑] 异常

这些函数不抛异常。

[编辑] 返回值

1) 若原子访问使用无锁指令则为 true
2,3) 被指向的共享指针的副本。
4,5) (无)
6,7) 先前被指向共享指针的副本
8,9,10,11) 若共享指针等价并进行交换则为 true ,否则为 false

[编辑] 注意

并发 TS 提供原子智能指针类 atomic_shared_ptratomic_weak_ptr ,作为这些函数使用的替用。

[编辑] 示例

[编辑] 参阅

检查对该原子类型的操作是否是无锁的
(函数模板) [编辑]
原子地以非原子参数替换原子对象的值
(函数模板) [编辑]
原子地获得存储于原子对象的值
(函数模板) [编辑]
原子地以非原子参数的值替换原子对象的值,并返回该原子对象的旧值
(函数模板) [编辑]
原子地比较原子对象和非原子参数的值,若相等则进行 atomic_exchange ,若不相等则进行 atomic_load
(函数模板) [编辑]