Skip to main content

QueuedInputSource

Struct QueuedInputSource 

Source
pub struct QueuedInputSource<M>
where M: EventMapper,
{ /* private fields */ }
Expand description

Pull-based input source backed by an unbounded FIFO.

A successful enqueue appends the entire mapped batch behind older pending events. Mapping occurs in a temporary vector, so a mapping error never commits a partial batch to the queue. The generic mapper’s own state follows its EventMapper::map_batch contract; the queue cannot roll it back.

Implementations§

Source§

impl<M> QueuedInputSource<M>
where M: EventMapper,

Source

pub fn new(mapper: M) -> Self

Source

pub fn mapper(&self) -> &M

Source

pub fn mapper_mut(&mut self) -> &mut M

Source

pub fn enqueue_batch(&mut self, batch: &EventBatch) -> Result<usize, M::Error>

Map and atomically append the logical events in one framework batch.

Physical diagnostic edges are intentionally not mapped by this adapter. On success, returns the number of downstream events appended.

Source

pub fn enqueue_events( &mut self, events: &[ButtonEvent], ) -> Result<usize, M::Error>

Map and atomically append an ordered domain-event slice.

Source

pub fn next_event(&mut self) -> Option<M::Output>

Source

pub fn pending_len(&self) -> usize

Source

pub fn is_empty(&self) -> bool

Source

pub fn drain(&mut self) -> Vec<M::Output>

Remove and return every pending event in FIFO order.

Source

pub fn flush_to<S>( &mut self, sink: &mut S, ) -> Result<usize, FlushError<S::Error>>
where S: TryEventSink<M::Output>,

Try to deliver every pending event to sink in FIFO order.

When a send fails, ownership of the rejected event is returned by the sink, restored to the front of the queue, and included in the next retry. Already accepted events are removed exactly once; the untouched tail remains in its original order.

Source

pub fn into_parts(self) -> (M, VecDeque<M::Output>)

Trait Implementations§

Source§

impl<M> Clone for QueuedInputSource<M>
where M: EventMapper + Clone, M::Output: Clone,

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<M> Debug for QueuedInputSource<M>
where M: EventMapper + Debug, M::Output: Debug,

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.