Struct Uptime 

pub struct Uptime {
    pub awake: Duration,
    pub elapsed: Duration,
}

A moment read on both monotonic clocks at once.

The fields are counted from a fixed point in the past — the machine’s boot where the platform offers it, otherwise the first reading in this process — so a single Uptime is only meaningful next to another one. Keep the reading you started from and compare.

use qframe::uptime::Uptime;

let started = Uptime::now();
// ... the application runs, and the machine may be suspended in between ...
let now = Uptime::now();
let worked = now.awake.saturating_sub(started.awake);
let asleep = now.suspended_since(&started);
assert_eq!(asleep, std::time::Duration::ZERO, "nothing slept in a test");
assert!(worked < std::time::Duration::from_secs(1));

Fields

awake: Duration

Time counted by the clock that stops while the machine is asleep.

elapsed: Duration

Time counted by the clock that keeps going while the machine is asleep. Equal to awake on a platform with no second clock; see Uptime::detects_suspend.

Implementations

impl Uptime

pub fn now() -> Self

Reads both clocks now.

pub fn suspended_since(&self, earlier: &Self) -> Duration

How long the machine was suspended between earlier and this reading.

Zero when the readings are in the wrong order, and zero on a platform that cannot tell sleep apart.

pub fn detects_suspend() -> bool

Whether this platform has a second clock, so Uptime::suspended_since can report sleep at all. true on Linux and Android, false everywhere else.

Trait Implementations

impl Clone for Uptime

fn clone(&self) -> Uptime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Uptime

impl Debug for Uptime

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

Formats the value using the given formatter.

impl Eq for Uptime

impl Hash for Uptime

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Uptime

fn cmp(&self, other: &Uptime) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Uptime

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Uptime

fn partial_cmp(&self, other: &Uptime) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Uptime