Struct texcraft_stdext::collections::nevec::Nevec

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

Non-empty vector type.

Implementations

impl<T> Nevec<T>

pub fn new(first: T) -> Nevec<T>

Creates a new Nevec with the provided first element.

pub fn with_capacity(first: T, capacity: usize) -> Nevec<T>

Creates a new Nevec with the provided first element and initial capacity.

pub fn new_with_tail(first: T, tail: Vec<T>) -> Nevec<T>

Creates a new Nevec with the provided first element and remaining elements (“the tail”).

pub fn last(&self) -> &T

Gets a reference to the last element of the vector. Because the vector is guaranteed to be non-empty, this will always succeed.

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

Gets a mutable reference to the last element of the vector. Because the vector is guaranteed to be non-empty, this will always succeed.

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

Pushes an element onto the end of the vector.

pub fn pop(self) -> T

Pops an element from the end of the vector.

Because the vector is guaranteed to be non-empty, this will always succeed. However if the vector has only 1 element, then after popping it will no longer be non-empty. For this reason, the pop method takes ownership of the vector, and destroys it in the process.

In the case when the vector has more than 1 element, the method pop_from_tail can be used to retrieve the last element without destroying the vector.

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

Pops an element from the tail of the vector; that is, the part of the vector after the first element.

Returns None if and only if the vector has exactly 1 element. In this case the method pop is needed to take ownership of the element.

pub fn len(&self) -> usize

Returns the length of the vector, which is guaranteed to be at least 1.

pub fn is_empty(&self) -> bool

Returns whether the vector is non-empty, which it always is.

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

Get a reference to the element at the provided index.

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

Get a mutable reference to the element at the provided index.

Trait Implementations

impl<T: Clone> Clone for Nevec<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Nevec<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Nevec<T>

fn default() -> Nevec<T>

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for Nevec<T>where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: Display> Display for Nevec<T>

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

Formats the value using the given formatter.

impl<T> Index<usize> for Nevec<T>

type Output = T

The returned type after indexing.

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

Performs the indexing (container[index]) operation.

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

type Item = &'a T

The type of the elements being iterated over.

type IntoIter = NevecIter<'a, T>

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

impl<T> Serialize for Nevec<T>where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.