Struct nonempty::NonEmpty

pub struct NonEmpty<T>(_, _);

Methods

impl<T> NonEmpty<T>

pub const fn new(e: T) -> Self

Alias for NonEmpty::singleton.

pub const fn singleton(e: T) -> Self

Create a new non-empty list with an initial element.

pub const fn is_empty(&self) -> bool

Always returns false.

pub const fn first(&self) -> &T

Get the first element. Never fails.

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

Push an element to the end of the list.

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

Pop an element from the end of the list.

pub fn len(&self) -> usize

Get the length of the list.

pub fn last(&self) -> &T

Get the last element. Never fails.

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

Get the last element mutably.

pub fn get(&self, index: usize) -> Option<&T>

Get an element by index.

pub fn get_mut(&mut self, index: usize) -> Option<&mut T>

Get an element by index, mutably.

pub fn truncate(&mut self, len: usize)

Truncate the list to a certain size. Must be greater than 0.

pub fn iter<'a>(&'a self) -> impl Iterator<Item = &T> + 'a

use nonempty::NonEmpty;

let mut l = NonEmpty::new(42);
l.push(36);
l.push(58);

let mut l_iter = l.iter();

assert_eq!(l_iter.next(), Some(&42));
assert_eq!(l_iter.next(), Some(&36));
assert_eq!(l_iter.next(), Some(&58));
assert_eq!(l_iter.next(), None);

Trait Implementations

impl<T> Into<Vec<T>> for NonEmpty<T>

fn into(self) -> Vec<T>

Turns a non-empty list into a Vec.

impl<T: Clone> Clone for NonEmpty<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for NonEmpty<T>

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

Formats the value using the given formatter.