命名空间
变体
操作

std::atomic_flag_wait, std::atomic_flag_wait_explicit

来自 cppreference.cn
< cpp‎ | atomic
 
 
并发支持库
线程
(C++11)
(C++20)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
协作取消
互斥
(C++11)
通用锁管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
条件变量
(C++11)
信号量
闩锁和屏障
(C++20)
(C++20)
期物
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
危害指针
原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(C++20 中已弃用)
(C++11)(C++20 中已弃用)
内存顺序
(C++11)(C++26 中已弃用)
原子操作的自由函数
原子标志的自由函数
atomic_flag_waitatomic_flag_wait_explicit
(C++20)(C++20)
 
定义于头文件 <atomic>
void atomic_flag_wait( const atomic_flag* object, bool old ) noexcept;
(1) (自 C++20 起)
void atomic_flag_wait( const volatile atomic_flag* object,
                       bool old ) noexcept;
(2) (自 C++20 起)
void atomic_flag_wait_explicit( const atomic_flag* object,
                                bool old, std::memory_order order ) noexcept;
(3) (自 C++20 起)
void atomic_flag_wait_explicit( const volatile atomic_flag* object,
                                bool old, std::memory_order order ) noexcept;
(4) (自 C++20 起)

执行原子等待操作。

object->test(std::memory_order_seq_cst)object->test(order)old 进行比较,如果它们相等,则阻塞,直到 *objectstd::atomic_flag::notify_one()std::atomic_flag::notify_all() 通知(或者线程被虚假地解除阻塞)。重复此操作,直到值比较不相等。

1,2) 内存同步顺序为 std::memory_order_seq_cst
3,4) 内存同步顺序为 order
如果 orderstd::memory_order_releasestd::memory_order_acq_rel 之一,则行为未定义。

即使底层实现虚假地解除阻塞,这些函数也保证仅在值已更改时返回。

目录

[edit] 参数

object - 指向要检查和等待的原子标志的指针
old - 要检查原子标志不再包含的值
order - 内存同步顺序

[edit] 返回值

(无)

[edit] 注解

这种形式的更改检测通常比简单的轮询或纯自旋锁更有效。

由于 ABA 问题,从 old 到另一个值然后返回到 old 的瞬时更改可能会被错过,并且不会解除阻塞。

[edit] 示例

[edit] 参见

通知至少一个等待原子对象的线程
std::atomic_flag 的公共成员函数) [编辑]
通知所有阻塞等待原子对象的线程
std::atomic_flag 的公共成员函数) [编辑]
通知在 atomic_flag_wait 中阻塞的线程
(函数) [编辑]
通知所有在 atomic_flag_wait 中阻塞的线程
(函数) [编辑]