命名空间
变体
操作

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] 参数

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

[edit] 返回值

(无)

[edit] 注意

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

由于 ABA 问题,从 old 到另一个值再回到 old 的瞬时变化可能会被错过,而不会解除阻塞。

[edit] 示例

[edit] 参见

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