名稱空間
變體
操作

std::shared_timed_mutex::try_lock_shared_until

來自 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 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) 丟擲的任何異常(標準庫提供的時鐘、時間點和持續時間永遠不會丟擲異常)。

[編輯] 示例

[編輯] 參閱

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