Struct index_ext::tag::Idx

pub struct Idx<I, Tag> { /* private fields */ }

A valid index for all slices of the same length.

While this has a generic parameter, you can only instantiate this type for specific types through one of the constructors of a corresponding [Prefix] struct.

Implementations

impl<T, I> Idx<I, T>

pub fn into_inner(self) -> I

Get the inner index.

pub fn with_tag<NewT>(self, larger: TagLessEq<T, NewT>) -> Idx<I, NewT>

Interpret this as an index into a larger slice.

impl<T> Idx<usize, T>

pub fn saturating_sub(self, sub: usize) -> Self

Create a smaller index.

pub fn truncate(self, min: usize) -> Self

Bound the index from above.

pub fn into_range(self) -> Idx<Range<usize>, T>

Return the range that contains this element.

pub fn into_len(self) -> Prefix<T>

Get a length up-to, not including this index.

pub fn into_end(self) -> NonZeroLen<T>

Get the length beyond this index.

Unlike turning it into a range and using its end, this guarantees that the end is non-zero as it knows the range not to be empty.

impl<T> Idx<RangeTo<usize>, T>

pub fn into_end(self) -> Prefix<T>

Get a length up-to, not including this index.

pub fn range_from(self, from: Prefix<T>) -> Option<Idx<Range<usize>, T>>

Construct an index starting at an element.

This method return Some when from does not exceed the end index.

impl<T> Idx<RangeFrom<usize>, T>

pub fn into_start(self) -> Prefix<T>

Get a length up-to, not including this index.

pub fn range_to(self, to: Prefix<T>) -> Option<Idx<Range<usize>, T>>

Construct an index up to at an element.

This method return Some when to does not exceed the end index.

impl<T> Idx<Range<usize>, T>

pub fn into_start(self) -> Prefix<T>

Get a length up-to, not including this index.

pub fn into_end(self) -> Prefix<T>

Get a length up-to, not including this index.

Trait Implementations

impl<I: Clone, Tag: Clone> Clone for Idx<I, Tag>

fn clone(&self) -> Idx<I, Tag>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Tag, E, I> Index<Idx<I, T>> for Slice<E, T>

where I: SliceIndex<[E]>,

type Output = <I as SliceIndex<[E]>>::Output

The returned type after indexing.

fn index(&self, idx: Idx<I, T>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T: Tag, E, I> IndexMut<Idx<I, T>> for Slice<E, T>

where I: SliceIndex<[E]>,

fn index_mut(&mut self, idx: Idx<I, T>) -> &mut Self::Output

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

impl<I: Copy, Tag: Copy> Copy for Idx<I, Tag>