Struct autofolder::ImplReduce

pub struct ImplReduce<Item> { /* private fields */ }

The ImplReduce type uses the ReduceTrait for the reduce function.

This is essentially an ImplFolder that doesn’t require an initial value - the first value to be “reduced” is incorporated as-is instead.

Example:

use autofolder::*;

// Create a type wrapper for usize:
#[derive(Debug)]
pub struct Usize(usize);

// Create an autofolder that collects the max Usize.
let mut max = ImplReduce::<Usize>::default();

// Implement ReduceTrait for the desired ImplReduce type.
autofolder_impl_reducetrait!(|a, b| -> Usize {
    Usize(std::cmp::max(a.0, b.0))
});

// We can "reduce-in" individual items.
// (note: as this is the first value, we incorporate it
//  without calling the trait function)
max.reduce(Usize(3));

// We can then peek at the running output:
println!("Partial max is {:?}", max.as_ref());

// And still keep on folding by processing whole iterators:
max.extend((1..=5).map(Usize));

// And finally consume the autofolder to get the final output value:
let max = max.into_inner().unwrap();
println!("Final max is {}", max.0);

Implementations

impl<Item> ImplReduce<Item>

pub fn new(initial: Item) -> Self

Creates a new ImplReduce with the provided initial value.

pub fn into_inner(self) -> Option<Item>

Deconstruct self and return the inner value.

pub fn as_ref(&self) -> Option<&Item>

Returns a reference to the inner value, if there is one.

pub fn reduce(&mut self, item: Item)where Self: ReduceTrait<Item>,

Reduce the given item into the current self item.

Trait Implementations

impl<Item: Clone> Clone for ImplReduce<Item>

fn clone(&self) -> ImplReduce<Item>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Item: Debug> Debug for ImplReduce<Item>

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

Formats the value using the given formatter.

impl<Item> Default for ImplReduce<Item>

fn default() -> Self

Returns the “default value” for a type.

impl<Item> Extend<Item> for ImplReduce<Item>where ImplReduce<Item>: ReduceTrait<Item>,

fn extend<It: IntoIterator<Item = Item>>(&mut self, iter: It)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<Item> From<Item> for ImplReduce<Item>

fn from(item: Item) -> Self

Converts to this type from the input type.

impl<Item> FromIterator<Item> for ImplReduce<Item>where ImplReduce<Item>: ReduceTrait<Item>,

fn from_iter<It: IntoIterator<Item = Item>>(iter: It) -> Self

Creates a value from an iterator.

impl<Item: Copy> Copy for ImplReduce<Item>