Struct strict::NonEmptyVec

pub struct NonEmptyVec<T> { /* fields omitted */ }

a mostly costless wrapping of a vec, ensuring there's always at least one element.

Follow the semantics of Vec (differing methods have a different name).

Implementations

impl<T> NonEmptyVec<T>

pub fn len(&self) -> NonZeroUsize

pub fn has_len(&self, len: usize) -> bool

pub fn first(&self) -> &T

pub fn first_mut(&mut self) -> &mut T

pub fn last(&self) -> &T

pub fn last_mut(&mut self) -> &mut T

pub fn take(self) -> T

take the first item, discard the rest

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

pub fn insert(&mut self, insertion_idx: usize, value: T)

pub fn pop(&mut self) -> Option<T>

Removes the last element from a vector and returns it, or None if it contains only one element

pub fn as_slice(&self) -> &[T]

pub fn as_mut_slice(&mut self) -> &mut [T]

pub fn remove(&mut self, idx: usize) -> Result<T, NotEnoughElementsError>

pub fn swap_remove(&mut self, idx: usize) -> Result<T, NotEnoughElementsError>

Trait Implementations

impl<T: Clone> Clone for NonEmptyVec<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for NonEmptyVec<T>

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

Formats the value using the given formatter.

impl<T> Deref for NonEmptyVec<T>

type Target = [T]

The resulting type after dereferencing.

fn deref(&self) -> &[T]

Dereferences the value.

impl<T> From<T> for NonEmptyVec<T>

fn from(value: T) -> Self

Performs the conversion.

impl<T, I: SliceIndex<[T]>> Index<I> for NonEmptyVec<T>

type Output = I::Output

The returned type after indexing.

fn index(&self, index: I) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T, I: SliceIndex<[T]>> IndexMut<I> for NonEmptyVec<T>

fn index_mut(&mut self, index: I) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<'a, T> IntoIterator for &'a mut NonEmptyVec<T>

type Item = &'a mut T

The type of the elements being iterated over.

type IntoIter = IterMut<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> IterMut<'a, T>

Creates an iterator from a value.

impl<'a, T> IntoIterator for &'a NonEmptyVec<T>

type Item = &'a T

The type of the elements being iterated over.

type IntoIter = Iter<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Iter<'a, T>

Creates an iterator from a value.

impl<T> TryFrom<Vec<T>> for NonEmptyVec<T>

type Error = NotEnoughElementsError

The type returned in the event of a conversion error.

fn try_from(vec: Vec<T>) -> Result<Self, Self::Error>

Performs the conversion.