std::jthread(C++20)

namespace std {
  class jthread;
}

概要

クラスjthreadは、threadと同じく、新しい実行のスレッド(thread of execution)（以下、単にスレッドとする）の作成／待機／その他操作を行う機構を提供する。このクラスはさらに、実行しているスレッドに対する停止要求を扱う機能や、自動でjoin操作を行う機能を提供する。

threadクラスとの違い

• 停止要求のサポート: jthreadは自身と関連付けられたスレッドに対する停止要求を扱う仕組みを提供する。このために<stop_token>ヘッダに定義されたクラスを利用する。
• 自動join機能: jthreadはデストラクタやムーブ代入演算子が呼び出されたとき、もし自身に関連付けられたスレッドが存在する場合は、スレッドの停止要求を作成し、その後join()を呼び出してスレッドの終了を待機する。そのためthreadクラスと異なり、joinable() == true であってもデストラクタやムーブ代入演算子を呼び出し可能であり、std::terminate()は呼び出されない。

メンバ関数

静的メンバ関数

メンバ型

非メンバ関数

備考

• 型native_handle_typeおよびメンバ関数native_handleについて、同メンバの存在有無およびその意味は処理系定義となる。
• 型idおよび型native_handle_typeは、threadクラスで定義しているものと同じものを使用する。

例

#include <cassert>
#include <thread>

int main()
{
  int x = 0, y = 0;

  std::jthread t([&](std::stop_token st) { x++; });

  // スレッドに対する停止要求の作成に合わせて呼び出される
  // コールバックを定義する。
  std::stop_callback sc { t.get_stop_token(), [&] { y++; }};

  assert(y == 0);

  // 明示的にjoin()を呼び出さずにtを上書きする。
  // このとき、ムーブ代入演算子の呼び出しの中で、
  // 自動で停止要求の作成とjoin()の呼び出しが行われる。
  t = std::jthread{};

  assert(x == 1 && y == 1);

  return 0;
}

出力

バージョン

言語

• C++20

処理系

• Clang: ??
• GCC: ??
• ICC: ??

参照