pub trait Folder<Item>: Sized {
    type Result;

    fn consume(self, item: Item) -> Self;
    fn complete(self) -> Self::Result;
    fn full(&self) -> bool;

    fn consume_iter<I>(self, iter: I) -> Self
        I: IntoIterator<Item = Item>
, { ... } }
Expand description

The Folder trait encapsulates the standard fold operation. It can be fed many items using the consume method. At the end, once all items have been consumed, it can then be converted (using complete) into a final value.

Required Associated Types

The type of result that will ultimately be produced by the folder.

Required Methods

Consume next item and return new sequential state.

Finish consuming items, produce final result.

Hint whether this Folder would like to stop processing further items, e.g. if a search has been completed.

Provided Methods

Consume items from the iterator until full, and return new sequential state.

This method is optional. The default simply iterates over iter, invoking consume and checking after each iteration whether full returns false.

The main reason to override it is if you can provide a more specialized, efficient implementation.