名稱空間
變體
操作

std::shared_timed_mutex::try_lock_for

來自 cppreference.com

[編輯模板]
 
C++
 
併發支援庫
執行緒
(C++11)
(C++20)
(C++17)(C++17)
this_thread 名稱空間
(C++11)
(C++11)
(C++11)
(C++11)
協同取消
互斥
(C++11)
(C++11)
(C++17)
通用鎖管理
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)
(C++11)
(C++11)
(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++20)
(C++20)
期值
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
(C++26)
(C++26)
危險指標
(C++26)
(C++26)
(C++26)
原子型別
(C++11)
(C++20)
(C++11)
原子型別的初始化
(C++11)(C++20 中已棄用)
(C++11)(C++20 中已棄用)
(C++11)
記憶體排序
(C++11)
(C++11)(C++26 中已棄用)
(C++11)
(C++11)
原子操作的自由函式
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
原子標誌的自由函式
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
 
std::shared_timed_mutex
 
template< class Rep, class Period >
bool try_lock_for( const std::chrono::duration<Rep, Period>& timeout_duration );
 (C++14 起)

嘗試鎖定互斥量。阻塞直到指定的持續時間 timeout_duration 已過去（超時）或鎖被獲取（擁有互斥量），以先發生者為準。成功獲取鎖時返回 true，否則返回 false。

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

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

標準建議使用 std::steady_clock 來測量持續時間。如果實現改用 std::system_clock，則等待時間也可能受時鐘調整的影響。

與 try_lock() 一樣，此函式允許虛假失敗，並返回 false，即使在 timeout_duration 期間的某個時間點互斥量未被任何其他執行緒鎖定。

如果對同一互斥量的先前 unlock() 操作返回 true，則它與此操作“同步”（如 std::memory_order 中定義）。

如果 `try_lock_for` 被已在任何模式（共享或獨佔）下擁有互斥量的執行緒呼叫，則行為未定義。

目錄

[編輯] 引數

timeout_duration - 最少阻塞持續時間

[編輯] 返回值

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

[編輯] 異常

timeout_duration 丟擲的任何異常（標準庫提供的持續時間從不丟擲）。

[編輯] 示例

執行此程式碼
#include <chrono>
#include <iostream>
#include <mutex>
#include <sstream>
#include <thread>
#include <vector>
 
using namespace std::chrono_literals;
 
std::mutex cout_mutex; // control access to std::cout
std::timed_mutex mutex;
 
void job(int id)
{
    std::ostringstream stream;
 
    for (int i = 0; i < 3; ++i)
    {
        if (mutex.try_lock_for(100ms))
        {
            stream << "success ";
            std::this_thread::sleep_for(100ms);
            mutex.unlock();
        }
        else
            stream << "failed ";
 
        std::this_thread::sleep_for(100ms);
    }
 
    std::lock_guard<std::mutex> lock{cout_mutex};
    std::cout << '[' << id << "] " << stream.str() << '\n';
}
 
int main()
{
    std::vector<std::thread> threads;
    for (int i{0}; i < 4; ++i)
        threads.emplace_back(job, i);
 
    for (auto& th : threads)
        th.join();
}

可能的輸出

[0] failed failed failed 
[3] failed failed success 
[2] failed success failed 
[1] success failed success

[編輯] 參閱

 鎖定互斥體，如果互斥體不可用則阻塞
(public member function) [編輯]
 嘗試鎖定互斥體，如果互斥體不可用則返回
(public member function) [編輯]
 嘗試鎖定互斥鎖，如果互斥鎖在指定超時時間內不可用，則返回
在指定時間點之前不可用
(public member function) [編輯]
 解鎖互斥體
(public member function) [編輯]
取自“https://cppreference.tw/mwiki/index.php?title=cpp/thread/shared_timed_mutex/try_lock_for&oldid=131033”