std::atomic_ref<T>:: wait

void wait ( value_type old, std:: memory_order order = std:: memory_order_seq_cst ) const noexcept ;		(constexpr C++26以降)

アトミックな待機操作を実行します。以下の手順を繰り返し実行するかのように動作します：

• this - > load ( order ) の 値表現 を old の値表現と比較する。
  • それらが等しい場合、 notify_one() または notify_all() によって * this が通知されるか、スレッドが偽起床するまでブロックする。
  • それ以外の場合、直ちに戻る。

これらの関数は、基盤となる実装が偽の解除を起こした場合でも、値が実際に変更された場合にのみ返ることが保証されています。

order が std:: memory_order_relaxed 、 std:: memory_order_consume 、 std:: memory_order_acquire または std:: memory_order_seq_cst でない場合、動作は未定義です。

目次 1 パラメータ 2 注記 3 例 4 関連項目

パラメータ

old	-	atomic_ref のオブジェクトが保持しなくなった値をチェックする
order	-	適用するメモリ順序制約

注記

この形式の変更検出は、単純なポーリングや純粋なスピンロックよりも効率的な場合が多いです。

ABA問題 のため、 old から別の値へ一時的に変化し、再び old に戻る変更が見逃され、ブロック解除が行われない可能性があります。

比較はビット単位で行われます（ std::memcmp と同様）。比較演算子は使用されません。オブジェクトの値表現に決して関与しないパディングビットは無視されます。

例

このセクションは不完全です 理由: 例がありません

関連項目

notify_one	アトミックオブジェクトを待機している少なくとも1つのスレッドに通知する (public member function)
notify_all	アトミックオブジェクトを待機しているすべてのスレッドに通知する (public member function)
atomic_notify_one (C++20)	atomic_waitでブロックされているスレッドに通知する (function template)
atomic_notify_all (C++20)	atomic_waitでブロックされているすべてのスレッドに通知する (function template)