namespace std {
class condition_variable_any;
}
概要
condition_variable_any
は、特定のイベントもしくは条件を満たすまでスレッドの実行を待機するためのクラスである。
wait()
/wait_for()
/wait_until()
を使用してスレッドを待機させ、notify_one()
/notify_all()
によって待機しているスレッドを起床させる。
condition_variable
はロック型としてunique_lock<mutex>
のみをサポートしているが、condition_variable_any
はあらゆるロック型をサポートしている。
condition_variable_any
の適切な利用については、条件変数の利用方法も参照のこと。
メンバ関数
名前 | 説明 | 対応バージョン |
---|---|---|
(constructor) |
コンストラクタ | C++11 |
(destructor) |
デストラクタ | C++11 |
operator=(const condition_variable_any&) = delete; |
代入演算子 | C++11 |
notify_one |
待機しているスレッドをひとつ起床させる | C++11 |
notify_all |
待機している全てのスレッドを起床させる | C++11 |
wait |
起床されるまで待機する | C++11 |
wait_for |
相対時間のタイムアウトを指定して、起床されるまで待機する | C++11 |
wait_until |
絶対時間のタイムアウトを指定して、起床されるまで待機する | C++11 |
例
#include <iostream>
#include <condition_variable>
#include <mutex>
#include <thread>
struct ProcessData {
std::recursive_mutex mtx_;
std::condition_variable_any cond_;
bool data_ready_ = false;
public:
// 処理に必要なデータの準備をする
void prepare_data_for_processing()
{
// ...準備処理...
{
std::lock_guard<std::recursive_mutex> lk(mtx_);
data_ready_ = true;
}
// 準備完了したので待機スレッドを起床させる
cond_.notify_one();
}
void wait_for_data_to_process()
{
std::unique_lock<std::recursive_mutex> lk(mtx_);
// データの準備ができるまで待機してから処理する
cond_.wait(lk, [this] { return data_ready_; });
process_data();
}
private:
void process_data()
{
// ...データを処理する...
std::cout << "process data" << std::endl;
}
};
int main()
{
ProcessData p;
std::thread t1([&] { p.prepare_data_for_processing(); });
std::thread t2([&] { p.wait_for_data_to_process(); });
t1.join();
t2.join();
}
出力
process data
バージョン
言語
- C++11
処理系
- Clang: ??
- GCC: ??
- ICC: ??
- Visual C++: 2012 ✅, 2013 ✅