Trait asparit::Folder

pub trait Folder<I>: Sized {
    type Result;
    pub fn consume(self, item: I) -> Self;
    pub fn complete(self) -> Self::Result;

    pub fn consume_iter<X>(self, iter: X) -> Self
    where
        X: IntoIterator<Item = I>,
    { ... }
    pub fn is_full(&self) -> bool { ... }
}

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.

Associated Types

type Result

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

Loading content...

Required methods

pub fn consume(self, item: I) -> Self

Consume next item and return new sequential state.

pub fn complete(self) -> Self::Result

Finish consuming items, produce final result.

Loading content...

Provided methods

pub fn consume_iter<X>(self, iter: X) -> Self where
    X: IntoIterator<Item = I>, 

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.

pub fn is_full(&self) -> bool

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

Loading content...

Implementors

Loading content...