Enum TimerOverrunPolicy 

pub enum TimerOverrunPolicy {
    Skip,
    CatchUp,
}

What a periodic timer does with periods it missed while its executor was blocked (issue #505).

A tier that loses the CPU for several periods — a long-running callback, or preemption by a higher-priority band — resumes with accumulated elapsed time worth more than one period.

Variants

Skip

Coalesce the backlog: fire ONCE and drop the missed periods, counting them in overruns. Phase is preserved (the sub-period remainder carries over), so activations stay aligned to the original cadence grid instead of drifting by each stall.

The default, matching rclcpp (which advances the next call time past “now”) and Zephyr’s k_timer (which coalesces expiries and reports a count).

CatchUp

Replay every missed period, one activation per try_process pass, until the backlog drains. Correct for timers that count or accumulate, where each activation is a unit of work that must not be lost. A replay burst runs back-to-back at dispatch speed, NOT at the declared cadence — control loops usually want Skip.

Trait Implementations

impl Clone for TimerOverrunPolicy

fn clone(&self) -> TimerOverrunPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TimerOverrunPolicy

impl Debug for TimerOverrunPolicy

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

Formats the value using the given formatter.

impl Default for TimerOverrunPolicy

fn default() -> TimerOverrunPolicy

Returns the “default value” for a type.

impl Eq for TimerOverrunPolicy

impl PartialEq for TimerOverrunPolicy

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TimerOverrunPolicy