名前空間
変種
操作

std::shared_timed_mutex::try_lock_until

From cppreference.com
 
 
並行性サポートライブラリ
スレッド
(C++11)
(C++20)
this_thread 名前空間
(C++11)
(C++11)
(C++11)
協調的なキャンセル
排他制御
(C++11)
汎用ロック管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
条件変数
(C++11)
セマフォ
ラッチとバリア
(C++20)
(C++20)
future
(C++11)
(C++11)
(C++11)
(C++11)
安全なメモリ解放 (Safe Reclamation)
(C++26)
ハザードポインタ
アトミック型
(C++11)
(C++20)
アトミック型の初期化
(C++11)(C++20で非推奨)
(C++11)(C++20で非推奨)
メモリオーダー
(C++11)(C++26で非推奨)
アトミック操作のためのフリー関数
アトミックフラグのためのフリー関数
 
 
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() と同様に動作します。

ClockClock の要件を満たす必要があります。プログラムは、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
English 日本語 中文(简体) 中文(繁體)