std::shared_timed_mutex::try_lock_until
| template< class Clock, class Duration > bool try_lock_until( const std::chrono::time_point<Clock, Duration>& timeout_time ); |
(C++14以降) | |
ミューテックスのロックを試みます。指定された 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() と同様に、この関数は気まぐれに失敗し、timeout_time より前にミューテックスが他のスレッドによってロックされていなかったとしても false を返すことがあります。
同じミューテックスに対する先行する unlock() 操作は、true を返す場合、この操作と(std::memory_order で定義される)*同期*します。
すでにいずれかのモード(共有または排他)でミューテックスを所有しているスレッドから try_lock_until が呼び出された場合、動作は未定義です。
目次 |
[編集] パラメータ
| timeout_time | - | ブロックする最大時間点 |
[編集] 戻り値
ロックが正常に取得された場合は true、それ以外の場合は false。
[編集] 例外
timeout_time によってスローされる可能性のある例外(標準ライブラリで提供されるクロック、時間点、および期間は決して例外をスローしません)。
[編集] 例
| このセクションは未完成です 理由: 例がありません |
[編集] 関連項目
| ミューテックスをロックします。ミューテックスが利用できない場合はブロックします (public メンバ関数) | |
| ミューテックスをロックしようとします。ミューテックスが利用できない場合は戻ります (public メンバ関数) | |
| ミューテックスをロックしようとします。ミューテックスが 指定されたタイムアウト期間利用できなかった場合は戻ります (public メンバ関数) | |
| ミューテックスをアンロックします (public メンバ関数) | |
| Cドキュメント (
mtx_timedlock) | |