std::atomic_ref<T>::wait
来自 cppreference.cn
< cpp | atomic | atomic ref
void wait( value_type old, std::memory_order order = std::memory_order_seq_cst ) const noexcept; |
(C++26 起为 constexpr) | |
执行原子等待操作。其行为等同于重复执行以下步骤:
- 将 this->load(order) 的值表示与 old 的值表示进行比较。
- 如果它们相等,则阻塞直到 *this 被 notify_one() 或 notify_all() 通知,或者线程被虚假地解除阻塞。
- 否则,返回。
即使底层实现虚假唤醒,这些函数也保证只有在值发生变化时才返回。
如果 order 不是 std::memory_order_relaxed、std::memory_order_consume、std::memory_order_acquire 或 std::memory_order_seq_cst,则行为未定义。
目录 |
[编辑] 参数
old | - | 要检查的 `atomic_ref` 对象不再包含的值 |
顺序 | - | 要强制执行的内存顺序约束 |
[编辑] 注意
这种形式的变更检测通常比简单的轮询或纯自旋锁更高效。
由于 ABA 问题,从 old 到另一个值然后又回到 old 的瞬时变化可能会被错过,而不会解除阻塞。
比较是按位进行的(类似于 std::memcmp);不使用比较运算符。不参与对象值表示的填充位将被忽略。
[编辑] 示例
本节不完整 原因:无示例 |
[编辑] 另请参阅
通知至少一个等待原子对象的线程 (公共成员函数) | |
通知所有被原子对象阻塞的线程 (公共成员函数) | |
(C++20) |
通知一个在 atomic_wait 中阻塞的线程 (函数模板) |
(C++20) |
通知所有在 atomic_wait 中阻塞的线程 (函数模板) |