Enum WaitTimeoutStatus 

pub enum WaitTimeoutStatus {
    Woken,
    TimedOut,
}

Result of a timed wait operation.

This status is returned by MonitorGuard::wait_timeout and Monitor::wait_notify. It describes why a timed wait returned, but callers must still re-check the protected state because condition variables may wake spuriously.

Example

use std::time::Duration;

use qubit_lock::lock::{Monitor, WaitTimeoutStatus};

let monitor = Monitor::new(false);
let guard = monitor.lock();
let (_guard, status) = guard.wait_timeout(Duration::from_millis(1));
assert_eq!(status, WaitTimeoutStatus::TimedOut);

Variants

Woken

The wait returned before the timeout elapsed.

This usually means another thread called Monitor::notify_one or Monitor::notify_all, but it may also be a spurious wakeup. Always re-check the guarded state before acting on this status.

TimedOut

The wait reached the timeout boundary.

Even after this status, callers should inspect the protected state because another thread may have changed it while the waiting thread was reacquiring the mutex.

Trait Implementations

impl Clone for WaitTimeoutStatus

fn clone(&self) -> WaitTimeoutStatus

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WaitTimeoutStatus

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for WaitTimeoutStatus

fn eq(&self, other: &WaitTimeoutStatus) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for WaitTimeoutStatus

impl Eq for WaitTimeoutStatus

impl StructuralPartialEq for WaitTimeoutStatus