std::latch::count_down(C++20)

void count_down(ptrdiff_t update = 1);

概要

ラッチのカウンタ値をupdateだけ減算し、カウンタ値が0になれば待機中スレッドのブロック解除を行う。

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

事前条件

update >= 0 かつ update <= counter

効果

アトミックにcounter -= updateを実行する。 counterが0と等しければ、*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();
}

std::latch::count_down(C++20)

概要

事前条件

効果

戻り値

例外

例

出力

バージョン

言語

処理系

関連項目