命名空间
变体
操作

std::atomic_flag_wait, std::atomic_flag_wait_explicit

来自 cppreference.com
< 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 中已弃用)
内存排序
用于原子操作的自由函数
用于原子标志的自由函数
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 中的一个,则行为是未定义的。

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

内容

[编辑] 参数

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

[编辑] 返回值

(无)

[编辑] 注释

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

由于 ABA 问题,从 old 到另一个值再回到 old 的瞬态变化可能会被忽略,并且不会解除阻塞。

[编辑] 示例

[编辑] 另请参见

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