namespace std {
template <class Callable, class ...Args>
void call_once(once_flag& flag, Callable func, Args&&... args);
}
概要
指定された関数を一度だけ呼び出す。
この関数は主に、複数スレッド間で共通使用するデータの初期化処理などで使用する。
効果
パラメータflag
が初期状態であれば、func
関数オブジェクトにargs...
を適用して呼び出し、そうでなければfunc
関数オブジェクトを呼び出さない。
func
関数オブジェクトの呼び出しが例外を送出する場合、その例外はcall_once()
関数の呼び出し元に伝達され、パラメータflag
は初期状態のままとなる。
戻り値
なし
例外
- システムのAPIで何らかのエラーが発生した場合、
system_error
例外が送出される。 func
関数オブジェクトの呼び出しによって送出される、あらゆる例外が送出される可能性がある。
備考
func
関数オブジェクトの呼び出しが例外を送出した場合、同じパラメータflag
を指定した次のcall_once
にて関数オブジェクトが呼び出される。また、同じパラメータflag
を指定した複数call_once()
において、指定された各関数オブジェクトの呼び出しは同時に行われない。(全順序が保証される)
例
#include <iostream>
#include <thread>
#include <mutex>
std::once_flag once;
void init()
{
// 初期化を行う...
std::cout << "initialize" << std::endl;
}
void thread_proc()
{
std::call_once(once, init);
}
int main()
{
std::thread t1(thread_proc);
std::thread t2(thread_proc);
std::thread t3(thread_proc);
t1.join();
t2.join();
t3.join();
}
出力
initialize
バージョン
言語
- C++11
処理系
- Clang: ??
- GCC: 4.7.0 ✅
- ICC: ??
- Visual C++: 2012 ✅, 2013 ✅, 2015 ✅
参照
- LWG Issue 2080. Specify when
once_flag
becomes invalid- C++11では、
once_flag
が無効(invalid)な場合にsystem_error
が送出される仕様になっていた。実際には、once_flag
が無効になる状況はないため、C++14でこの例外仕様が削除された。
- C++11では、