Struct rc_slice::RcSlice

pub struct RcSlice<T> { /* fields omitted */ }

A read-only view into an underlying reference-counted slice.

The associated functions provided for this type do not take a receiver to avoid conflicting with (present or future) methods on [T], since RcSlice<T>: Deref<Target = [T]>.

Implementations

impl<T> RcSlice<T>

pub fn bounds(it: &Self) -> (usize, usize)

Returns the starting and ending indices of the view it within the underlying slice.

pub fn advance(it: &mut Self, incr: usize) -> Option<&[T]>

Increases the starting index of it by incr places, and returns a reference to the elements cut off by this operation.

Returns None and leaves it unchanged if this operation would make the starting index greater than the ending index.

pub fn retract(it: &mut Self, decr: usize) -> Option<&[T]>

Decreases the ending index of it by decr places, and returns a reference to the elements cut off by this operation.

Returns None and leaves it unchanged if this operation would make the ending index less than the starting index.

pub fn split_off_before(it: &mut Self, index: usize) -> Option<Self>

Mutates the view it to point to only the first index elements of the underlying slice, and returns a new view of the remaining elements.

Returns None and leaves it unchanged if the underlying slice has fewer than index elements.

pub fn split_off_after(it: &mut Self, index: usize) -> Option<Self>

Returns a new view of the first index elements of the underlying slice, and mutates it to point to only the remaining elements.

Returns None and leaves it unchanged if the underlying slice has fewer than index elements.

Trait Implementations

impl<T> AsRef<[T]> for RcSlice<T>

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

Performs the conversion.

impl<T> Clone for RcSlice<T>

pub fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Deref for RcSlice<T>

type Target = [T]

The resulting type after dereferencing.

pub fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> From<Rc<[T]>> for RcSlice<T>

pub fn from(underlying: Rc<[T]>) -> Self

Performs the conversion.