Struct OneOrMany

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

Struct containing either a single item or a list of items of type T. If a single item is present, first will contain it and rest will be empty. If multiple items are present, first will contain the first item and rest will contain the rest. IMPORTANT: this struct cannot be created with an empty vector. OneOrMany objects can only be created using OneOrMany::from() or OneOrMany::try_from().

Implementations

impl<T: Clone> OneOrMany<T>

pub fn first(&self) -> T

Get the first item in the list.

pub fn rest(&self) -> Vec<T>

Get the rest of the items in the list (excluding the first one).

pub fn push(&mut self, item: T)

After OneOrMany<T> is created, add an item of type T to the rest.

pub fn len(&self) -> usize

Length of all items in OneOrMany<T>.

pub fn is_empty(&self) -> bool

If OneOrMany<T> is empty. This will always be false because you cannot create an empty OneOrMany<T>. This method is required when the method len exists.

pub fn one(item: T) -> Self

Create a OneOrMany object with a single item of any type.

pub fn many(items: Vec<T>) -> Result<Self, EmptyListError>

Create a OneOrMany object with a vector of items of any type.

pub fn merge( one_or_many_items: Vec<OneOrMany<T>>, ) -> Result<Self, EmptyListError>

Merge a list of OneOrMany items into a single OneOrMany item.

pub fn iter(&self) -> Iter<'_, T>

pub fn iter_mut(&mut self) -> IterMut<'_, T>

Trait Implementations

impl<T: Clone> Clone for OneOrMany<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for OneOrMany<T>

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

Formats the value using the given formatter.

impl<T: Clone> IntoIterator for OneOrMany<T>

Implement Iterator for IntoIter<T>.

type Item = T

The type of the elements being iterated over.

type IntoIter = IntoIter<T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T: PartialEq> PartialEq for OneOrMany<T>

fn eq(&self, other: &OneOrMany<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 OneOrMany<T>

impl<T> StructuralPartialEq for OneOrMany<T>