最終更新日時: 2025年07月12日 02時16分44秒 (JST)
Koichi Murase が更新

履歴 編集

class
<condition_variable>

# std::condition_variable_any(C++11)

    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 ✅

## 参照