Namespaces
Variants

std::atomic_flag:: wait

From cppreference.net

Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
Memory ordering
(C++11) (deprecated in C++26)
Free functions for atomic operations
Free functions for atomic flags
void wait ( bool old, std:: memory_order order =
std:: memory_order_seq_cst ) const noexcept ;
(1) (C++20以降)
(C++26以降 constexpr)
void wait ( bool old,

std:: memory_order order =

std:: memory_order_seq_cst ) const volatile noexcept ;
(2) (C++20以降)

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

  • this - > test ( 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_flag オブジェクトが保持しなくなった値をチェックする値
order - 適用するメモリ順序制約

注記

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

ABA問題 のため、 old から別の値へ、そして old へ戻る一時的な変更は検出されず、ブロック解除されない可能性があります。


関連項目

(C++20)
アトミックオブジェクトを待機している少なくとも1つのスレッドに通知する
(公開メンバ関数)
(C++20)
アトミックオブジェクトを待機している全てのスレッドに通知する
(公開メンバ関数)
atomic_flag_waitでブロックされているスレッドに通知する
(関数)
atomic_flag_waitでブロックされている全てのスレッドに通知する
(関数)