# Enum itertools::EitherOrBoth

``````pub enum EitherOrBoth<A, B> {
Both(A, B),
Left(A),
Right(B),
}``````
Expand description

Value that either holds a single A or B, or both.

## Variants§

§

### Both(A, B)

Both values are present.

§

### Left(A)

Only the left value of type `A` is present.

§

### Right(B)

Only the right value of type `B` is present.

## Implementations§

source§

### impl<A, B> EitherOrBoth<A, B>

source

#### pub fn has_left(&self) -> bool

If `Left`, or `Both`, return true, otherwise, return false.

source

#### pub fn has_right(&self) -> bool

If `Right`, or `Both`, return true, otherwise, return false.

source

#### pub fn is_left(&self) -> bool

If Left, return true otherwise, return false. Exclusive version of `has_left`.

source

#### pub fn is_right(&self) -> bool

If Right, return true otherwise, return false. Exclusive version of `has_right`.

source

#### pub fn is_both(&self) -> bool

If Right, return true otherwise, return false. Equivalent to `self.as_ref().both().is_some()`.

source

#### pub fn left(self) -> Option<A>

If `Left`, or `Both`, return `Some` with the left value, otherwise, return `None`.

source

#### pub fn right(self) -> Option<B>

If `Right`, or `Both`, return `Some` with the right value, otherwise, return `None`.

source

#### pub fn both(self) -> Option<(A, B)>

If Both, return `Some` tuple containing left and right.

source

#### pub fn as_ref(&self) -> EitherOrBoth<&A, &B>

Converts from `&EitherOrBoth<A, B>` to `EitherOrBoth<&A, &B>`.

source

#### pub fn as_mut(&mut self) -> EitherOrBoth<&mut A, &mut B>

Converts from `&mut EitherOrBoth<A, B>` to `EitherOrBoth<&mut A, &mut B>`.

source

#### pub fn flip(self) -> EitherOrBoth<B, A>

Convert `EitherOrBoth<A, B>` to `EitherOrBoth<B, A>`.

source

#### pub fn map_left<F, M>(self, f: F) -> EitherOrBoth<M, B>where F: FnOnce(A) -> M,

Apply the function `f` on the value `a` in `Left(a)` or `Both(a, b)` variants. If it is present rewrapping the result in `self`’s original variant.

source

#### pub fn map_right<F, M>(self, f: F) -> EitherOrBoth<A, M>where F: FnOnce(B) -> M,

Apply the function `f` on the value `b` in `Right(b)` or `Both(a, b)` variants. If it is present rewrapping the result in `self`’s original variant.

source

#### pub fn map_any<F, L, G, R>(self, f: F, g: G) -> EitherOrBoth<L, R>where F: FnOnce(A) -> L, G: FnOnce(B) -> R,

Apply the functions `f` and `g` on the value `a` and `b` respectively; found in `Left(a)`, `Right(b)`, or `Both(a, b)` variants. The Result is rewrapped `self`’s original variant.

source

#### pub fn left_and_then<F, L>(self, f: F) -> EitherOrBoth<L, B>where F: FnOnce(A) -> EitherOrBoth<L, B>,

Apply the function `f` on the value `a` in `Left(a)` or `Both(a, _)` variants if it is present.

source

#### pub fn right_and_then<F, R>(self, f: F) -> EitherOrBoth<A, R>where F: FnOnce(B) -> EitherOrBoth<A, R>,

Apply the function `f` on the value `b` in `Right(b)` or `Both(_, b)` variants if it is present.

source

#### pub fn or(self, l: A, r: B) -> (A, B)

Returns a tuple consisting of the `l` and `r` in `Both(l, r)`, if present. Otherwise, returns the wrapped value for the present element, and the supplied value for the other. The first (`l`) argument is used for a missing `Left` value. The second (`r`) argument is used for a missing `Right` value.

Arguments passed to `or` are eagerly evaluated; if you are passing the result of a function call, it is recommended to use `or_else`, which is lazily evaluated.

##### Examples
``````assert_eq!(EitherOrBoth::Both("tree", 1).or("stone", 5), ("tree", 1));
assert_eq!(EitherOrBoth::Left("tree").or("stone", 5), ("tree", 5));
assert_eq!(EitherOrBoth::Right(1).or("stone", 5), ("stone", 1));``````
source

#### pub fn or_default(self) -> (A, B)where A: Default, B: Default,

Returns a tuple consisting of the `l` and `r` in `Both(l, r)`, if present. Otherwise, returns the wrapped value for the present element, and the `default` for the other.

source

#### pub fn or_else<L: FnOnce() -> A, R: FnOnce() -> B>(self, l: L, r: R) -> (A, B)

Returns a tuple consisting of the `l` and `r` in `Both(l, r)`, if present. Otherwise, returns the wrapped value for the present element, and computes the missing value with the supplied closure. The first argument (`l`) is used for a missing `Left` value. The second argument (`r`) is used for a missing `Right` value.

##### Examples
``````let k = 10;
assert_eq!(EitherOrBoth::Both("tree", 1).or_else(|| "stone", || 2 * k), ("tree", 1));
assert_eq!(EitherOrBoth::Left("tree").or_else(|| "stone", || 2 * k), ("tree", 20));
assert_eq!(EitherOrBoth::Right(1).or_else(|| "stone", || 2 * k), ("stone", 1));``````
source§

### impl<T> EitherOrBoth<T, T>

source

#### pub fn reduce<F>(self, f: F) -> Twhere F: FnOnce(T, T) -> T,

Return either value of left, right, or the product of `f` applied where `Both` are present.

## Trait Implementations§

source§

### impl<A: Clone, B: Clone> Clone for EitherOrBoth<A, B>

source§

#### fn clone(&self) -> EitherOrBoth<A, B>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from `source`. Read more
source§

### impl<A: Debug, B: Debug> Debug for EitherOrBoth<A, B>

source§

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

Formats the value using the given formatter. Read more
source§

### impl<A: Hash, B: Hash> Hash for EitherOrBoth<A, B>

source§

#### fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given `Hasher`. Read more
1.3.0 · source§

#### fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given `Hasher`. Read more
source§

### impl<A, B> Into<Option<Either<A, B>>> for EitherOrBoth<A, B>

source§

#### fn into(self) -> Option<Either<A, B>>

Converts this type into the (usually inferred) input type.
source§

### impl<A: PartialEq, B: PartialEq> PartialEq for EitherOrBoth<A, B>

source§

#### fn eq(&self, other: &EitherOrBoth<A, B>) -> bool

This method tests for `self` and `other` values to be equal, and is used by `==`.
1.0.0 · source§

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

This method tests for `!=`. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

source§

source§

§

§

§

§

§

## Blanket Implementations§

source§

### impl<T> Any for Twhere T: 'static + ?Sized,

source§

#### fn type_id(&self) -> TypeId

Gets the `TypeId` of `self`. Read more
source§

### impl<T> Borrow<T> for Twhere T: ?Sized,

source§

#### fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

### impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

#### fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

### impl<T> From<T> for T

source§

#### fn from(t: T) -> T

Returns the argument unchanged.

source§

### impl<T, U> Into<U> for Twhere U: From<T>,

source§

#### fn into(self) -> U

Calls `U::from(self)`.

That is, this conversion is whatever the implementation of `From<T> for U` chooses to do.

source§

### impl<T> ToOwned for Twhere T: Clone,

§

#### type Owned = T

The resulting type after obtaining ownership.
source§

#### fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

#### fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

### impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

#### type Error = Infallible

The type returned in the event of a conversion error.
source§

#### fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

### impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

#### type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

#### fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.