std::shared_timed_mutex::try_lock_shared_until
來自 cppreference.com
< cpp | thread | shared timed mutex
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,則程式格式錯誤。(自 C++20 起)
標準建議使用與 timeout_time 繫結的時鐘,在這種情況下可以考慮時鐘的調整。因此,阻塞的持續時間可能會比呼叫時 timeout_time - Clock::now() 更長或更短,具體取決於調整方向以及實現是否遵循該調整。該函式還可能由於程序排程或資源爭用延遲而阻塞到 timeout_time 之後。
與 try_lock_shared() 一樣,此函式允許虛假失敗並返回 false,即使在 timeout_time 之前某個時刻互斥量沒有被任何其他執行緒鎖定。
如果同一互斥量上的先前 unlock() 操作返回 true,則它與此操作“同步”(如 std::memory_order 中所定義)。
如果 `try_lock_shared_until` 被一個已經以任何模式(共享或獨佔)擁有 `mutex` 的執行緒呼叫,則行為未定義。
目錄 |
[編輯] 引數
timeout_time | - | 最大阻塞時間點 |
[編輯] 返回值
如果成功獲取共享鎖所有權,則為 true,否則為 false。
[編輯] 異常
在執行過程中,時鐘 (clock)、時間點 (time_point) 或持續時間 (duration) 丟擲的任何異常(標準庫提供的時鐘、時間點和持續時間永遠不會丟擲異常)。
[編輯] 示例
本節不完整 原因:無示例 |
[編輯] 參閱
嘗試鎖定互斥鎖,如果互斥鎖在指定超時時間內不可用,則返回 在指定時間點之前不可用 (公共成員函式) | |
嘗試以共享所有權鎖定互斥體,如果互斥體不可用則返回 (公共成員函式) | |
嘗試以共享所有權鎖定互斥鎖,如果互斥鎖在指定超時時間內不可用,則返回 指定超時持續時間不可用 (公共成員函式) |