Struct Handoff 

pub struct Handoff<M, const N: usize> { /* private fields */ }

Bounded FIFO between two callbacks running on different SchedContexts. Generic over message type M (must be Send for cross-thread executors) and capacity N.

Constructed via Handoff::new; share between callbacks via std::sync::Arc<Handoff<M, N>>.

Implementations

impl<M, const N: usize> Handoff<M, N>

pub fn new() -> Self

Empty queue.

pub fn push(&self, msg: M) -> Result<(), M>

Push a message. Non-blocking on the high-priority side — returns Err(msg) when the queue is full so the caller can decide whether to drop, overwrite, or escalate. O(1) under the internal mutex.

pub fn pop(&self) -> Option<M>

Pop one message. Returns None when the queue is empty. O(N) under the internal mutex (shifts the tail of the heapless::Vec); switch to a true ring buffer if the dispatcher’s bench shows this as a hotspot.

pub fn len(&self) -> usize

Current depth. Useful for monitoring + telemetry.

pub fn is_empty(&self) -> bool

True when empty.

pub fn is_full(&self) -> bool

True when at capacity. Caller’s push will return Err(msg) on the next call until a pop drains a slot.

pub const fn capacity(&self) -> usize

Compile-time capacity.

Trait Implementations

impl<M: Debug, const N: usize> Debug for Handoff<M, N>

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

Formats the value using the given formatter.

impl<M, const N: usize> Default for Handoff<M, N>

fn default() -> Self

Returns the “default value” for a type.