std::recursive_timed_mutex::try_lock_until
| template< class Clock, class Duration > bool try_lock_until( const std::chrono::time_point<Clock, Duration>& timeout_time ); |
(C++11以降) | |
ミューテックスのロックを試みます。指定された timeout_time に到達するか、ロックが取得される（ミューテックスを所有する）までブロックします。どちらが先に発生したかで終了します。ロックの取得に成功した場合は true を返しますが、それ以外の場合は false を返します。
もし timeout_time が既に経過している場合、この関数は try_lock() と同様に動作します。
Clock は Clock の要件を満たす必要があります。プログラムは、std::chrono::is_clock_v<Clock> が false の場合、ill-formed です。(C++20以降)
timeout_time に関連付けられたクロックが使用されることが標準で推奨されています。この場合、クロックの調整が考慮されることがあります。したがって、ブロック期間は、呼び出し時の timeout_time - Clock::now() よりも長くなったり短くなったりする可能性があります。これは、調整の方向と、実装によってそれが尊重されるかどうかに依存します。また、プロセススケジューリングやリソース競合による遅延のため、timeout_time を過ぎてブロックすることもあります。
try_lock() と同様に、この関数は誤って失敗し、false を返すことが許可されています。たとえ、ある時点で timeout_time より前にミューテックスが他のどのスレッドにもロックされていなかったとしてもです。
この関数が true を返した場合、同じミューテックスに対する以前の unlock() 操作は、この操作と synchronizes-with ( std::memory_order で定義されている) します。
スレッドは再帰ミューテックスに対して `try_lock_until` を繰り返し呼び出すことができます。`try_lock_until` の成功した呼び出しは所有権カウントをインクリメントします。ミューテックスは、スレッドが対応する回数だけ unlock を呼び出した後にのみ解放されます。
所有権の最大レベル数は未指定です。この数を超えた場合、`try_lock_until` の呼び出しは false を返します。
目次 |
[編集] パラメータ
| timeout_time | - | ブロックする最大時間点 |
[編集] 戻り値
ロックが正常に取得された場合は true、それ以外の場合は false。
[編集] 例外
timeout_time によってスローされる可能性のある例外（標準ライブラリで提供されるクロック、時間点、および期間は決して例外をスローしません）。
[編集] 例
| このセクションは未完成です 理由: 例がありません |
欠陥レポート
以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。
| DR | 適用対象 | 公開された動作 | 正しい動作 |
|---|---|---|---|
| LWG 2093 | C++11 | try_lock_until は何も投げません |
タイムアウト関連の例外を投げます |
[編集] 関連項目
| ミューテックスをロックします。ミューテックスが利用できない場合はブロックします (public メンバ関数) | |
| ミューテックスをロックしようとします。ミューテックスが利用できない場合は戻ります (public メンバ関数) | |
| ミューテックスをロックしようとします。ミューテックスが 指定されたタイムアウト期間利用できなかった場合は戻ります (public メンバ関数) | |
| ミューテックスをアンロックします (public メンバ関数) | |
| Cドキュメント （
mtx_timedlock） | |
