Struct StdTimer 

pub struct StdTimer { /* private fields */ }

A real-time asynchronous timer backed by std::time::Instant.

Every standard Timer in the process shares one scheduler worker. The worker starts lazily with the first future registration and remains parked while idle so later registrations do not need to create another native thread. If that worker exits unexpectedly, its active futures are awakened and return TimeError::TimerUnavailable with TimerUnavailableError::SchedulerWorkerTerminated instead of remaining pending or reporting false deadline completion. A later registration starts a replacement worker generation.

Implementations

impl StdTimer

pub fn new() -> Self

Creates a timer backed by a new standard monotonic clock.

Returns

A timer with a fresh clock domain and the process-wide scheduler.

pub fn from_clock(clock: &StdMonotonicClock) -> Self

Creates a timer sharing the supplied standard clock’s exact domain.

Parameters

• clock - Standard clock whose domain and origin drive this timer.

Returns

A timer retaining the process-wide lazy scheduler.

Trait Implementations

impl Debug for StdTimer

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

Formats the retained clock without exposing scheduler internals.

Parameters

• formatter - Destination formatter.

Returns

Ok(()) when formatting succeeds.

Errors

Returns std::fmt::Error when the destination rejects output.

impl Default for StdTimer

fn default() -> Self

Creates a standard timer with a fresh clock domain.

Returns

A standard timer with a newly allocated clock domain.

Panics

Panics if all process-wide clock-domain identifiers are exhausted.

impl Timer for StdTimer

fn clock(&self) -> &dyn MonotonicClock

Returns the private same-domain standard clock handle.

Returns

The monotonic clock driving this timer.

fn at(&self, deadline: MonotonicInstant) -> Result<TimerFuture, TimeError>

Eagerly registers an absolute deadline with the shared scheduler.

Parameters

• deadline - Deadline in this timer’s clock domain.

Returns

A cancellation-safe future whose registration is already active, or an immediately ready future for a reached deadline. The future returns TimeError::TimerUnavailable with TimerUnavailableError::SchedulerWorkerTerminated when its scheduler worker exits unexpectedly.

Errors

Returns a domain mismatch, native-instant overflow, or scheduler startup error before returning a future.

Panics

Panics when scheduler registration identifiers or worker generations are exhausted, or an internal scheduler index invariant is violated.

fn after(&self, duration: Duration) -> Result<TimerFuture, TimeError>

Eagerly registers a relative deadline with the shared scheduler.

This implementation samples the native instant once, avoiding the monotonic-domain conversion required by the default trait method.

Parameters

• duration - Delay before the future becomes ready.

Returns

A cancellation-safe future whose registration is already active, or an immediately ready future for a zero duration.

Errors

Returns TimeError::InstantOverflow when the native deadline cannot be represented, or a scheduler startup error before returning a future.

Panics

Panics when scheduler registration identifiers or worker generations are exhausted, or an internal scheduler index invariant is violated.