Struct AtomicOptTimestamp 

pub(crate) struct AtomicOptTimestamp {
    latest: AtomicU64,
}

An object for determining whether an event happened, and if yes, when it happened.

Every Timestamp has internal mutability. A timestamp can move forward in time, but never backwards.

Internally, it uses the coarsetime crate to represent times in a way that lets us do atomic updates.

Fields

latest: AtomicU64

A timestamp (from coarsetime) describing when this timestamp was last updated.

I’d rather just use coarsetime::Instant, but that doesn’t have an atomic form.

Implementations

impl AtomicOptTimestamp

pub(crate) const fn new() -> Self

Construct a new timestamp that has never been updated.

pub(crate) fn update(&self)

Update this timestamp to (at least) the current time.

pub(crate) fn update_if_none(&self)

If the timestamp is currently unset, then set it to the current time. Otherwise leave it alone.

pub(crate) fn clear(&self)

Clear the timestamp and make it not updated again.

pub(crate) fn time_since_update(&self) -> Option<Duration>

Return the time since update was last called.

Return None if update was never called.

pub(crate) fn time_since_update_at(&self, now: Instant) -> Option<Duration>

Return the time between the time when update was last called, and the time now.

Return None if update was never called, or now is before that time.

pub(crate) fn update_to(&self, now: Instant)

Update this timestamp to (at least) the time now.

Trait Implementations

impl Debug for AtomicOptTimestamp

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

Formats the value using the given formatter.

impl Default for AtomicOptTimestamp

fn default() -> AtomicOptTimestamp

Returns the “default value” for a type.