Struct MessageParIter 

pub struct MessageParIter<'a, M>
where
    M: Message,
{ /* private fields */ }

Available on crate feature multi_threaded only.

A parallel iterator over Messages.

Implementations

impl<'a, M> MessageParIter<'a, M>

where M: Message,

pub fn new( reader: &'a mut MessageCursor<M>, messages: &'a Messages<M>, ) -> MessageParIter<'a, M>

Creates a new parallel iterator over messages that have not yet been seen by reader.

pub fn batching_strategy( self, strategy: BatchingStrategy, ) -> MessageParIter<'a, M>

Changes the batching strategy used when iterating.

For more information on how this affects the resultant iteration, see BatchingStrategy.

pub fn for_each<FN>(self, func: FN)

where FN: Fn(&'a M) + Send + Sync + Clone,

Runs the provided closure for each unread message in parallel.

Unlike normal iteration, the message order is not guaranteed in any form.

Panics

If the ComputeTaskPool is not initialized. If using this from a message reader that is being initialized and run from the ECS scheduler, this should never panic.

pub fn for_each_with_id<FN>(self, func: FN)

where FN: Fn(&'a M, MessageId<M>) + Send + Sync + Clone,

Runs the provided closure for each unread message in parallel, like for_each, but additionally provides the MessageId to the closure.

Note that the order of iteration is not guaranteed, but MessageIds are ordered by send order.

Panics

If the ComputeTaskPool is not initialized. If using this from a message reader that is being initialized and run from the ECS scheduler, this should never panic.

pub fn len(&self) -> usize

Returns the number of Messages to be iterated.

pub fn is_empty(&self) -> bool

Returns true if there are no messages remaining in this iterator.

Trait Implementations

impl<'a, M> Debug for MessageParIter<'a, M>

where M: Debug + Message,

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

Formats the value using the given formatter.

impl<'a, M> IntoIterator for MessageParIter<'a, M>

where M: Message,

type IntoIter = MessageIteratorWithId<'a, M>

Which kind of iterator are we turning this into?

type Item = <<MessageParIter<'a, M> as IntoIterator>::IntoIter as Iterator>::Item

The type of the elements being iterated over.

fn into_iter(self) -> <MessageParIter<'a, M> as IntoIterator>::IntoIter

Creates an iterator from a value.