名稱空間
變體
操作

std::shared_timed_mutex::try_lock_shared_for

來自 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)
期值
(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 Rep, class Period >
bool try_lock_shared_for( const std::chrono::duration<Rep,Period>& timeout_duration );
(C++14 起)

嘗試以共享模式鎖定互斥量。阻塞直到指定的 timeout_duration 已過去或者共享鎖被獲取,以先發生者為準。成功獲取鎖時返回 true,否則返回 false

如果 timeout_duration 小於或等於 timeout_duration.zero(),則此函式的行為與 try_lock_shared() 相同。

由於排程或資源競爭延遲,此函式可能會阻塞超過 timeout_duration 的時間。

標準建議使用穩定時鐘來測量持續時間。如果實現使用系統時鐘,則等待時間也可能對時鐘調整敏感。

try_lock_shared() 類似,此函式允許虛假失敗並返回 false,即使在 timeout_duration 期間的某個時刻,互斥量並未被任何其他執行緒鎖定。

如果返回 true,則此操作與在同一互斥量上先前的 unlock() 操作同步(如 std::memory_order 中定義)。

如果一個執行緒已經以任何模式(共享或獨佔)擁有 mutex,然後呼叫 try_lock_shared_for,則行為是未定義的。

目錄

[編輯] 引數

timeout_duration - 最大阻塞持續時間

[編輯] 返回值

如果成功獲取鎖,則為 true,否則為 false

[編輯] 異常

在執行過程中,時鐘 (clock)、時間點 (time_point) 或持續時間 (duration) 丟擲的任何異常(標準庫提供的時鐘、時間點和持續時間永遠不會丟擲異常)。

[編輯] 示例

[編輯] 參閱

嘗試以共享所有權鎖定互斥體,如果互斥體不可用則返回
(public member function) [編輯]
嘗試以共享所有權鎖定互斥鎖,如果互斥鎖在指定超時時間內不可用,則返回
在指定時間點之前不可用
(public member function) [編輯]
嘗試鎖定互斥鎖,如果互斥鎖在指定超時時間內不可用,則返回
指定超時持續時間不可用
(public member function) [編輯]