Struct NonEmptySlice

pub struct NonEmptySlice<'a, T: Sized> { /* private fields */ }

A non-empty slice type, counterpart of &[T].

Implementations

impl<'a, T: Sized> NonEmptySlice<'a, T>

pub fn from_ref(e: &'a T) -> Self

Converts a &T into a NonEmptySlice.

pub fn from_slice(slice: &'a [T]) -> Self

Converts a &[T] into a NonEmptySlice.

Panics

This function will panic if the passed slice is empty.

pub const fn from_slice_checked(slice: &'a [T]) -> Option<Self>

Converts a &[T] into a NonEmptySlice. Returns None if the passed slice is empty.

pub fn as_ptr(&self) -> *const T

Returns a raw pointer to the slice’s buffer.

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

Returns a &[T] containing entire NonEmptySlice.

pub const fn len(&self) -> NonZeroUsize

Returns the number of elements in the slice.

pub const fn is_empty(&self) -> bool

Always returns false because the slice is non-empty.

pub fn first(&self) -> &T

Returns the first element of the slice.

let s = NonEmptySlice::from_slice(&[10, 40, 30]);
assert_eq!(s.first(), &10);

pub fn last(&self) -> &T

Returns the last element of the slice.

let s = NonEmptySlice::from_slice(&[10, 40, 30]);
assert_eq!(s.last(), &30);

pub fn split_first(&self) -> (&T, &[T])

Returns the first and all the rest of the elements of the slice.

let s = NonEmptySlice::from_slice(&[10, 40, 30]);
assert_eq!(s.split_first(), (&10, &[40, 30][..]));

pub fn split_last(&self) -> (&T, &[T])

Returns the last and all the rest of the elements of the slice.

let s = NonEmptySlice::from_slice(&[10, 40, 30]);
assert_eq!(s.split_last(), (&30, &[10, 40][..]));

Trait Implementations

impl<'a, T> AsRef<[T]> for NonEmptySlice<'a, T>

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

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a, T: Clone> Clone for NonEmptySlice<'a, T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, T: Ord> Ord for NonEmptySlice<'a, T>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'a, T: PartialEq> PartialEq for NonEmptySlice<'a, T>

fn eq(&self, other: &Self) -> 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<'a, T: PartialOrd> PartialOrd for NonEmptySlice<'a, T>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a, T: Copy> Copy for NonEmptySlice<'a, T>

impl<'a, T: Eq> Eq for NonEmptySlice<'a, T>