GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing cpprefjp.github.io — std::thread::join - cpprefjp C++日本語リファレンス

最終更新日時: 2026年09月19日 21時31分51秒 (JST)
rotarymars が更新

function

std::thread::join(C++11)

void join();

概要

スレッドが終了するまで待機する

要件

threadオブジェクトにスレッドが関連付けられていること(joinable() == true)。

効果

thisに関連付けれられたスレッドが完了するまで、この関数を呼び出したスレッドをブロックする。

同期操作

関連付けられたスレッドの完了は、join()メンバ関数の正常リターンに対して同期する 。

つまり、「thisに関連付けられたスレッドT1上で行われる全処理の完了」は、「join()メンバ関数を呼び出したスレッドT0上での同メンバ関数からの正常リターン」よりも前に発生する 。

事後条件

thisは何も指さない空のthreadオブジェクトとなる。

例外

join操作に失敗した場合、system_error例外を投げる。

例

#include <cassert>
#include <thread>

int main()
{
  int x = 0;
  std::thread t([&]{ ++x; });

  // ここでxにアクセスするとdata raceにより未定義動作

  t.join();

  // 別スレッド上で行われた全処理が完了している
  assert(x == 1);

  return 0;
}

出力

バージョン

言語

C++11

処理系

Clang: 9.0.1 ✅
GCC: 4.6.3 ✅, 4.7.0 ✅
Visual C++: 2012 ✅, 2013 ✅, 2015 ✅
- 2012現在はバグ有り std::thread::join() hangs if called after main() exits when using VS2012 RC
  - main 関数を抜けた後に join() を呼ぶとハングアップするというもの

参照

LWG Issue 1033. thread::join() effects?
- C++11で、スレッドの完了までブロックするという効果が明記され、事後条件が「スレッドが完了していること」とget_id()==id()であることへ整理された

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.