Trait sp_std::slice::SliceIndex

pub unsafe trait SliceIndex<T>: Sealed where
    T: ?Sized, {
    type Output: ?Sized;
    fn get(self, slice: &T) -> Option<&Self::Output>;
    fn get_mut(self, slice: &mut T) -> Option<&mut Self::Output>;
    unsafe fn get_unchecked(self, slice: *const T) -> *const Self::Output;
    unsafe fn get_unchecked_mut(self, slice: *mut T) -> *mut Self::Output;
    fn index(self, slice: &T) -> &Self::Output;
    fn index_mut(self, slice: &mut T) -> &mut Self::Output;
}

A helper trait used for indexing operations.

Implementations of this trait have to promise that if the argument to get_(mut_)unchecked is a safe reference, then so is the result.

Associated Types

type Output: ?Sized

The output type returned by methods.

Required methods

fn get(self, slice: &T) -> Option<&Self::Output>

🔬 This is a nightly-only experimental API. (slice_index_methods)

Returns a shared reference to the output at this location, if in bounds.

fn get_mut(self, slice: &mut T) -> Option<&mut Self::Output>

🔬 This is a nightly-only experimental API. (slice_index_methods)

Returns a mutable reference to the output at this location, if in bounds.

unsafe fn get_unchecked(self, slice: *const T) -> *const Self::Output

🔬 This is a nightly-only experimental API. (slice_index_methods)

Returns a shared reference to the output at this location, without performing any bounds checking. Calling this method with an out-of-bounds index or a dangling slice pointer is undefined behavior even if the resulting reference is not used.

unsafe fn get_unchecked_mut(self, slice: *mut T) -> *mut Self::Output

🔬 This is a nightly-only experimental API. (slice_index_methods)

Returns a mutable reference to the output at this location, without performing any bounds checking. Calling this method with an out-of-bounds index or a dangling slice pointer is undefined behavior even if the resulting reference is not used.

fn index(self, slice: &T) -> &Self::Output

🔬 This is a nightly-only experimental API. (slice_index_methods)

Returns a shared reference to the output at this location, panicking if out of bounds.

fn index_mut(self, slice: &mut T) -> &mut Self::Output

🔬 This is a nightly-only experimental API. (slice_index_methods)

Returns a mutable reference to the output at this location, panicking if out of bounds.

Implementations on Foreign Types

impl<T> SliceIndex<[T]> for usize

type Output = T

pub fn get(self, slice: &[T]) -> Option<&T>

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub fn get_mut(self, slice: &mut [T]) -> Option<&mut T>

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub unsafe fn get_unchecked(self, slice: *const [T]) -> *const T

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub unsafe fn get_unchecked_mut(self, slice: *mut [T]) -> *mut T

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub fn index(self, slice: &[T]) -> &T

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub fn index_mut(self, slice: &mut [T]) -> &mut T

🔬 This is a nightly-only experimental API. (slice_index_methods)

impl<T> SliceIndex<[T]> for (Bound<usize>, Bound<usize>)

type Output = [T]

pub fn get(
    self,
    slice: &[T]
) -> Option<&<(Bound<usize>, Bound<usize>) as SliceIndex<[T]>>::Output>

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub fn get_mut(
    self,
    slice: &mut [T]
) -> Option<&mut <(Bound<usize>, Bound<usize>) as SliceIndex<[T]>>::Output>

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub unsafe fn get_unchecked(
    self,
    slice: *const [T]
) -> *const <(Bound<usize>, Bound<usize>) as SliceIndex<[T]>>::Output

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub unsafe fn get_unchecked_mut(
    self,
    slice: *mut [T]
) -> *mut <(Bound<usize>, Bound<usize>) as SliceIndex<[T]>>::Output

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub fn index(
    self,
    slice: &[T]
) -> &<(Bound<usize>, Bound<usize>) as SliceIndex<[T]>>::Output

🔬 This is a nightly-only experimental API. (slice_index_methods)

pub fn index_mut(
    self,
    slice: &mut [T]
) -> &mut <(Bound<usize>, Bound<usize>) as SliceIndex<[T]>>::Output

🔬 This is a nightly-only experimental API. (slice_index_methods)

Implementors

impl SliceIndex<str> for Range<usize>

impl SliceIndex<str> for RangeFrom<usize>

impl SliceIndex<str> for RangeFull

impl SliceIndex<str> for RangeInclusive<usize>

impl SliceIndex<str> for RangeTo<usize>

impl SliceIndex<str> for RangeToInclusive<usize>

impl<T> SliceIndex<[T]> for Range<usize>

impl<T> SliceIndex<[T]> for RangeFrom<usize>

impl<T> SliceIndex<[T]> for RangeFull

impl<T> SliceIndex<[T]> for RangeInclusive<usize>

impl<T> SliceIndex<[T]> for RangeTo<usize>

impl<T> SliceIndex<[T]> for RangeToInclusive<usize>