template <class Clock, class Duration>
bool try_lock_until(const chrono::time_point<Clock, Duration>& abs_time);
概要
タイムアウトする絶対時間を指定してロックの取得を試みる
テンプレートパラメータ制約
Mutex
型が、try_lock_until()
メンバ関数をサポートするミューテックス型であることchrono::is_clock_v<Clock>
がtrue
であること (C++20)
効果
pm->try_lock_until(abs_time);
※pm
はメンバ変数として保持している、ミューテックスオブジェクトへのポインタ
事後条件
owns_lock()
の値が、pm->try_lock_until(abs_time)
の戻り値になること
戻り値
pm->try_lock_until(abs_time)
の戻り値が返る
例外
この関数は、pm->try_lock_until()
関数内で投げられうるあらゆる例外を投げる可能性がある。
そのほかに、以下のerror conditionを持つsystem_error
例外オブジェクトを送出する可能性がある:
operation_not_permitted
:pm
がNULL
resource_deadlock_would_occur
:owns_lock() == true
の状態でこの関数が呼び出された
例
#include <iostream>
#include <thread>
#include <mutex>
#include <chrono>
#include <system_error>
class X {
std::timed_mutex mtx_;
int value_ = 0;
public:
// メンバ変数value_への書き込みを排他的にする
void add_value(int value)
{
std::unique_lock<std::timed_mutex> lk(mtx_, std::defer_lock);
namespace chrono = std::chrono;
chrono::system_clock::time_point tp = chrono::system_clock::now();
// ロックの取得を試みる(3秒後にタイムアウト)
if (!lk.try_lock_until(tp + chrono::seconds(3))) {
// ロックの取得に失敗
std::error_code ec(static_cast<int>(std::errc::device_or_resource_busy), std::generic_category());
throw std::system_error(ec);
}
value_ = value;
}
};
int main()
{
X x;
std::thread t1([&x]{ x.add_value(1); });
std::thread t2([&x]{ x.add_value(2); });
t1.join();
t2.join();
}
出力
バージョン
言語
- C++11
処理系
- Clang: ??
- GCC: 4.7.0 ✅
- ICC: ??
- Visual C++: 2012 ✅, 2013 ✅, 2015 ✅
- 2012, 2013は、例外の節で説明している
system_error
を投げる処理が実装されていない。
- 2012, 2013は、例外の節で説明している