std::shared_timed_mutex::try_lock_shared_until
| template< class Clock, class Duration > bool try_lock_shared_until( const std::chrono::time_point<Clock,Duration>& timeout_time ); |
(C++14以降) | |
ミューテックスを共有モードでロックしようとします。指定された timeout_time に達するか、ロックが取得されるまでブロックします。ロックの取得に成功した場合は true を返し、それ以外の場合は false を返します。
timeout_time がすでに経過している場合、この関数は try_lock_shared() と同様に動作します。
Clock は Clock の要件を満たす必要があります。プログラムは、std::chrono::is_clock_v<Clock> が false の場合、ill-formed です。(C++20以降)
timeout_time に関連付けられたクロックが使用されることが標準で推奨されています。この場合、クロックの調整が考慮されることがあります。したがって、ブロック期間は、呼び出し時の timeout_time - Clock::now() よりも長くなったり短くなったりする可能性があります。これは、調整の方向と、実装によってそれが尊重されるかどうかに依存します。また、プロセススケジューリングやリソース競合による遅延のため、timeout_time を過ぎてブロックすることもあります。
try_lock_shared() と同様に、この関数は偽陽性で失敗し、timeout_time より前にいつでもミューテックスが他のスレッドによってロックされていなかった場合でも false を返すことがあります。
同じミューテックスに対する先行する unlock() 操作は、true を返す場合、この操作と（std::memory_order で定義される）*同期*します。
try_lock_shared_until が、すでに (共有または排他モードのいずれかで) mutex を所有しているスレッドによって呼び出された場合、その動作は未定義です。
目次 |
[編集] パラメータ
| timeout_time | - | ブロックする最大時間点 |
[編集] 戻り値
共有ロックの所有権が正常に取得された場合は true、それ以外の場合は false。
[編集] 例外
実行中にクロック、time_point、または duration によってスローされる可能性のある例外（標準ライブラリで提供されるクロック、time_point、および duration は決して例外をスローしません）。
[編集] 例
| このセクションは未完成です 理由: 例がありません |
[編集] 関連項目
| ミューテックスをロックしようとします。ミューテックスが 指定された時刻まで利用できなかった場合は戻ります (public メンバ関数) | |
| 共有所有権のためにミューテックスをロックしようとします。ミューテックスが利用できない場合は戻ります (public メンバ関数) | |
| 共有所有権のためにミューテックスをロックしようとします。ミューテックスが 指定されたタイムアウト期間利用できなかった場合は戻ります (public member function) |
