std::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 より前に他のスレッドによってロックされていなかったとしてもです。
同じミューテックスに対する先行する unlock() 操作は、それが true を返す場合、この操作と 同期をとります （std::memory_order で定義されているように）。
もしスレッドが既にミューテックスを所有している状態で `try_lock_until` が呼び出された場合、その動作は未定義です。
目次 |
[編集] パラメータ
| timeout_time | - | ブロックする最大時間点 |
[編集] 戻り値
ロックが正常に取得された場合は true、それ以外の場合は false。
[編集] 例外
timeout_time によってスローされる可能性のある例外（標準ライブラリで提供されるクロック、時間点、および期間は決して例外をスローしません）。
[編集] 例
| このセクションは未完成です 理由: 例がありません |
欠陥レポート
以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。
| DR | 適用対象 | 公開された動作 | 正しい動作 |
|---|---|---|---|
| LWG 2093 | C++11 | try_lock_until は何も投げません |
タイムアウト関連の例外を投げます |
[編集] 関連項目
| ミューテックスをロックします。ミューテックスが利用できない場合はブロックします (public メンバ関数) | |
| ミューテックスをロックしようとします。ミューテックスが利用できない場合は戻ります (public メンバ関数) | |
| ミューテックスをロックしようとします。ミューテックスが 指定されたタイムアウト期間利用できなかった場合は戻ります (public メンバ関数) | |
| ミューテックスをアンロックします (public メンバ関数) | |
| Cドキュメント （
mtx_timedlock） | |
