Rust Condvar.wait_timeout用法及代碼示例

本文簡要介紹rust語言中 std::sync::Condvar.wait_timeout 的用法。

用法

pub fn wait_timeout<'a, T>(    &self,     guard: MutexGuard<'a, T>,     dur: Duration) -> LockResult<(MutexGuard<'a, T>, WaitTimeoutResult)>

在此條件變量上等待通知，在指定的持續時間後超時。

這個函數的語義等價於 wait ，除了線程將被阻塞大約不超過dur。由於搶占或平台差異等異常情況可能不會導致最大等待時間精確為 dur ，因此不應將此方法用於精確計時。

請注意，已盡最大努力確保使用單調時鍾測量等待的時間，並且不受係統時間更改的影響。此函數容易受到虛假喚醒的影響。條件變量通常有一個與之關聯的布爾謂詞，並且每次該函數返回時都必須檢查謂詞以防止虛假喚醒。此外，盡管存在虛假喚醒，但通常希望超時不超過某個持續時間，因此 sleep-duration 會減少睡眠量。或者，使用wait_timeout_while 方法在謂詞為真時等待超時。

返回的 WaitTimeoutResult 值指示是否已知超時已過。

與 wait 一樣，當此函數返回時，將重新獲取指定的鎖，無論是否超時。

例子

use std::sync::{Arc, Mutex, Condvar};
use std::thread;
use std::time::Duration;

let pair = Arc::new((Mutex::new(false), Condvar::new()));
let pair2 = Arc::clone(&pair);

thread::spawn(move|| {
    let (lock, cvar) = &*pair2;
    let mut started = lock.lock().unwrap();
    *started = true;
    // We notify the condvar that the value has changed.
    cvar.notify_one();
});

// wait for the thread to start up
let (lock, cvar) = &*pair;
let mut started = lock.lock().unwrap();
// as long as the value inside the `Mutex<bool>` is `false`, we wait
loop {
    let result = cvar.wait_timeout(started, Duration::from_millis(10)).unwrap();
    // 10 milliseconds have passed, or maybe the value changed!
    started = result.0;
    if *started == true {
        // We received the notification and the value has been updated, we can leave.
        break
    }
}

相關用法

注：本文由純淨天空篩選整理自rust-lang.org大神的英文原創作品 std::sync::Condvar.wait_timeout。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。