std::shared_timed_mutex::try_lock_shared_for
來自 cppreference.com
< cpp | thread | shared timed mutex
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) |