Struct Timestamp 

pub struct Timestamp(pub u64);

Monotonic nanoseconds from an arbitrary epoch chosen by the driver.

Nanoseconds, not milliseconds: milliseconds are too coarse for SRT pacing and catastrophically wrong for ST 2110-21. The epoch (what 0 means) is entirely up to whatever is driving the Stage — stages must treat Timestamp as an opaque, monotonically non-decreasing counter and never assume it relates to wall-clock time.

All arithmetic saturates rather than panicking: a Stage must not crash because a driver’s clock underflowed or overflowed.

Tuple Fields

0: u64

Implementations

impl Timestamp

pub const ZERO: Timestamp

The zero timestamp — whatever epoch the driver has chosen.

pub const fn from_nanos(nanos: u64) -> Self

Construct from a raw nanosecond count.

pub const fn as_nanos(self) -> u64

The raw nanosecond count since the driver’s chosen epoch.

pub const fn saturating_sub(self, other: Timestamp) -> Duration

self - other, saturating at zero instead of underflowing.

pub const fn checked_add_nanos(self, nanos: u64) -> Self

self + nanos, saturating at u64::MAX instead of overflowing.

pub fn saturating_add(self, duration: Duration) -> Self

self + duration, saturating at u64::MAX instead of overflowing.

A Duration in excess of u64::MAX nanoseconds saturates the same way.

impl Timestamp

pub fn from_instant(base: Instant, now: Instant) -> Self

Available on crate feature std only.

Derive a Timestamp from a std::time::Instant pair: now - base, expressed as nanoseconds since base.

base is whatever fixed instant the driver picked as its epoch (e.g. “when this stage was constructed”); every subsequent call converts an Instant to a Timestamp on the same epoch. This is a std-only convenience so std callers are not forced to hand-roll the subtraction; no_std drivers construct Timestamp directly.

Trait Implementations

impl Clone for Timestamp

fn clone(&self) -> Timestamp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Timestamp

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Default for Timestamp

fn default() -> Timestamp

Returns the “default value” for a type.

impl Eq for Timestamp

impl Hash for Timestamp

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 Timestamp

fn cmp(&self, other: &Timestamp) -> 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.

impl PartialEq for Timestamp

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Timestamp

fn partial_cmp(&self, other: &Timestamp) -> 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 Timestamp