Struct nslice::ExactSlice

pub struct ExactSlice<T, const N: usize> { /* private fields */ }

A reference to a region of memory which contains exactly N elements of type T.

ExactSlice is merely a way of reinterpreting an existing slice (&[T] or &mut [T]), but because there is no need to store a length for retrieval at runtime, its representation consists of just one pointer.

Implementations

impl<T, const N: usize> ExactSlice<T, N>

pub fn from_array(array: &[T; N]) -> &ExactSlice<T, N>

Produce a &ExactSlice from an array of N Ts.

pub fn from_mut_array(array: &mut [T; N]) -> &mut ExactSlice<T, N>

Produce a &mut ExactSlice from an array of N Ts.

pub fn from_slice(slice: &[T]) -> Option<&ExactSlice<T, N>>

Produce an &ExactSlice from a slice of Ts. Returns None if there are not the correct number of elements in slice.

pub fn from_mut(slice: &mut [T]) -> Option<&mut ExactSlice<T, N>>

Produce an &mut ExactSlice from a mutable slice of Ts. Returns None if there are not the correct number of elements in slice.

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

Returns a slice over the memory referred to by the ExactSlice. Its length is guaranteed to be exactly N.

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

Returns a mutable slice over the memory referred to by the ExactSlice. Its length is guaranteed to be exactly N.

pub fn as_min_slice(&self) -> &MinSlice<T, N>

Produce a &MinSlice from this &ExactSlice. Its tail will be empty.

pub fn as_mut_min_slice(&mut self) -> &mut MinSlice<T, N>

Produce a &mut MinSlice from this &min ExactSlice. Its tail will be empty.

pub unsafe fn from_slice_unchecked(slice: &[T]) -> &ExactSlice<T, N>

Produce an &ExactSlice from a slice of Ts without checking its length.

Safety

The caller is responsible for upholding the length invariant slice.len() == N, in addition to all normal slice invariants.

pub unsafe fn from_mut_unchecked(slice: &mut [T]) -> &mut ExactSlice<T, N>

Produce an &mut ExactSlice from a slice of Ts without checking its length.

Safety

The caller is responsible for upholding the length invariant slice.len() == N, in addition to all normal slice invariants.

Trait Implementations

impl<'a, T, const N: usize> Into<&'a ExactSlice<T, N>> for &'a MinSlice<T, N>

fn into(self) -> &'a ExactSlice<T, N>

Converts this type into the (usually inferred) input type.

impl<'a, T, const N: usize> Into<&'a MinSlice<T, N>> for &'a ExactSlice<T, N>

fn into(self) -> &'a MinSlice<T, N>

Converts this type into the (usually inferred) input type.

impl<'a, T, const N: usize> Into<&'a mut ExactSlice<T, N>> for &'a mut MinSlice<T, N>

fn into(self) -> &'a mut ExactSlice<T, N>

Converts this type into the (usually inferred) input type.

impl<'a, T, const N: usize> Into<&'a mut MinSlice<T, N>> for &'a mut ExactSlice<T, N>

fn into(self) -> &'a mut MinSlice<T, N>

Converts this type into the (usually inferred) input type.