Struct MergeBuilder

pub struct MergeBuilder<T> { /* private fields */ }

Helper for consuming items from an iterator and then creating a Merge.

By not collecting directly into Merge, we can avoid creating invalid instances of it. If we had Merge::from_iter() we would need to allow it to accept iterators of any length (including 0). We couldn’t make it panic on even lengths because we can get passed such iterators from e.g. Option::from_iter(). By collecting into MergeBuilder instead, we move the checking until after from_iter() (to MergeBuilder::build()).

Implementations

impl<T> MergeBuilder<T>

pub fn build(self) -> Merge<T>

Requires that exactly one more “adds” than “removes” have been added to this builder.

Trait Implementations

impl<T: Clone> Clone for MergeBuilder<T>

fn clone(&self) -> MergeBuilder<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for MergeBuilder<T>

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

Formats the value using the given formatter.

impl<T> Default for MergeBuilder<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T> Extend<T> for MergeBuilder<T>

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

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<T> FromIterator<T> for MergeBuilder<T>

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

Creates a value from an iterator.

impl<T: PartialEq> PartialEq for MergeBuilder<T>

fn eq(&self, other: &MergeBuilder<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: Eq> Eq for MergeBuilder<T>

impl<T> StructuralPartialEq for MergeBuilder<T>