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。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。