名稱空間
變體
操作

std::timed_mutex::try_lock_until

來自 cppreference.com
< cpp‎ | thread‎ | timed mutex
 
 
併發支援庫
執行緒
(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)
期值
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(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++11 起)

嘗試鎖定互斥量。阻塞直到達到指定的 timeout_time(超時)或獲得鎖(擁有互斥量),以先發生者為準。成功獲取鎖後返回 true,否則返回 false

如果 timeout_time 已經過去,則此函式行為類似於 try_lock()

Clock 必須滿足 Clock 要求。 如果 std::chrono::is_clock_v<Clock>false,則程式是非良構的。(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++ 標準。

缺陷報告 應用於 釋出時的行為 正確的行為
LWG 2093 C++11 try_lock_until 不丟擲任何異常 丟擲與超時相關的異常

[編輯] 參閱

鎖定互斥體,如果互斥體不可用則阻塞
(public member function) [編輯]
嘗試鎖定互斥體,如果互斥體不可用則返回
(public member function) [編輯]
嘗試鎖定互斥鎖,如果互斥鎖在指定超時時間內不可用,則返回
指定超時持續時間不可用
(public member function) [編輯]
解鎖互斥體
(public member function) [編輯]
C 文件,關於 mtx_timedlock