Struct OneOrMore 

pub struct OneOrMore<T> {
    head: T,
    tail: Vec<T>,
}

A container for at least one item. As a convenience, we don’t implement methods that reduce the length of the container (so that, for example, we don’t have to implement a fallible equivalent of pop()). However, the container is mutable in the sense that the items stored in it can be mutated.

Fields

head: T

tail: Vec<T>

Implementations

impl<T> OneOrMore<T>

pub fn new(head: T) -> OneOrMore<T>

Create an instance of OneOrMore<T> from a single T.

pub fn with_tail(head: T, tail: Vec<T>) -> OneOrMore<T>

Create an instance of OneOrMore<T> from a single T value and zero or more additional T values.

pub fn first(&self) -> &T

Return a reference to the first item.

pub fn last(&self) -> &T

Return a reference to the last item.

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

Append an item.

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

Return an iterator for the collection.

pub fn into_iter(self) -> OneOrMoreIntoIter<T>

Convert the collection into an iterator over the items of the collection.

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

Return a iterator for the collection which allows the items within it (but not the number of items) to be modified.

pub fn len(&self) -> usize

Return the number of items in the collection.

pub fn try_from_iter<I: Iterator<Item = T>>(it: I) -> Result<Self, NoItems>

Build an instance of OneOrMore<T> from a sequence of items, or fail (because there were no items).

pub fn extend<I: Iterator<Item = T>>(&mut self, items: I)

Append a (possibly empty) sequence of items.

pub fn try_from_vec(value: Vec<T>) -> Result<OneOrMore<T>, NoItems>

Attempt to convert an instance of OneOrMore<T> from a Vec<T>. This fails if the vector is empty.

pub fn as_parts(&self) -> (&T, &Vec<T>)

Return a reference the head of the collection (i.e. the first item) and a reference to the remaining items.

pub fn map<U, F: FnMut(&T) -> U>(&self, f: F) -> OneOrMore<U>

Create a non-empty collection by computing a mapping on the items on this collection.

pub fn into_map<U, F: FnMut(T) -> U>(self, f: F) -> OneOrMore<U>

Create a non-empty collection by computing a mapping on the items on this collection; this collection is dropped.

Trait Implementations

impl<T: Clone> Clone for OneOrMore<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for OneOrMore<T>

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

Formats the value using the given formatter.

impl From<OneOrMore<CommaDelimitedFragment>> for UntaggedProgramInstruction

fn from(fragments: OneOrMore<CommaDelimitedFragment>) -> Self

Converts to this type from the input type.

impl<T> From<OneOrMore<T>> for Vec<T>

fn from(value: OneOrMore<T>) -> Self

Converts to this type from the input type.

impl<T: PartialEq<T>> PartialEq<Vec<T>> for OneOrMore<T>

fn eq(&self, other: &Vec<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: PartialEq> PartialEq for OneOrMore<T>

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

impl<T> StructuralPartialEq for OneOrMore<T>