Struct LiveTimer 

pub struct LiveTimer {
    pub name: Ustr,
    pub interval_ns: NonZeroU64,
    pub start_time_ns: UnixNanos,
    pub stop_time_ns: Option<UnixNanos>,
    pub fire_immediately: bool,
    /* private fields */
}

A live timer for use with a LiveClock.

LiveTimer triggers events at specified intervals in a real-time environment, using Tokio’s async runtime to handle scheduling and execution.

Threading

The timer runs on the runtime thread that created it and dispatches events across threads as needed.

Fields

name: Ustr

The name of the timer.

interval_ns: NonZeroU64

The start time of the timer in UNIX nanoseconds.

start_time_ns: UnixNanos

The start time of the timer in UNIX nanoseconds.

stop_time_ns: Option<UnixNanos>

The optional stop time of the timer in UNIX nanoseconds.

fire_immediately: bool

If the timer should fire immediately at start time.

Implementations

impl LiveTimer

pub fn new( name: Ustr, interval_ns: NonZeroU64, start_time_ns: UnixNanos, stop_time_ns: Option<UnixNanos>, callback: TimeEventCallback, fire_immediately: bool, sender: Option<Arc<dyn TimeEventSender>>, ) -> Self

Creates a new LiveTimer instance.

Panics

Panics if name is not a valid string.

pub fn next_time_ns(&self) -> UnixNanos

Returns the next time in UNIX nanoseconds when the timer will fire.

Provides the scheduled time for the next event based on the current state of the timer.

pub fn is_expired(&self) -> bool

Returns whether the timer is expired.

An expired timer will not trigger any further events. A timer that has not been started is not expired.

pub fn start(&mut self)

Starts the timer.

Time events will begin triggering at the specified intervals. The generated events are handled by the provided callback function.

Panics

Panics if Rust-based callback system is active and no time event sender has been set.

pub fn cancel(&mut self)

Cancels the timer.

The timer will not generate a final event.

Trait Implementations

impl Debug for LiveTimer

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

Formats the value using the given formatter.