std::latch::wait

void wait() const;

概要

ラッチのカウンタ値が0になるまで待機する。

説明のため、ここではカウンタ値をcounterと表記する。

効果

counterが0に等しければ即座に制御を戻す。 そうでなければ、counterを0に減算するcount_down呼び出しが行われるまで、*this上で呼び出しスレッドをブロックする。

戻り値

なし

例外

この関数は、以下のerror conditionを持つsystem_error例外オブジェクトを送出する可能性がある：

• resource_unavailable_try_again : 操作対象のネイティブハンドル型が無効
• operation_not_permitted : スレッドにこの操作を行う権限がない
• invalid_argument : 実引数が無効

例

#include <iostream>
#include <latch>
#include <thread>

int main()
{
  int shared_data = 0;
  std::latch stored{1};

  std::thread t([&]{
    // 通知を待機し、共有データから読取り
    stored.wait();
    std::cout << shared_data << std::endl;
  });

  // 共有データへ書込み、通知を行う
  shared_data = 42;
  stored.count_down();

  t.join();
}

#include <iostream>

#include <latch>

#include <thread>

​

int main()

{

  int shared_data = 0;

  std::latch stored{1};

​

  std::thread t([&]{

    // 通知を待機し、共有データから読取り

    stored.wait();

    std::cout << shared_data << std::endl;

  });

​

  // 共有データへ書込み、通知を行う

  shared_data = 42;

  stored.count_down();

出力

42

バージョン

言語

• C++20

処理系

• Clang: 11.0 ✅
• GCC: ??
• ICC: ??
• Visual C++: ??

関連項目

• count_down()
• arrive_and_wait()