Trait ContiguousBorrowed

pub trait ContiguousBorrowed: SliceBorrowed + Unique {
    // Required method
    fn contiguous(&self) -> &[Self::Output];
}

A slice whose backing is contiguous in memory.

See also ContiguousMut. Note that there’s no ContiguousOwned: this is because Rust does not (yet) allow you to use associated constants in const operations, so there is no way to return an array.

The alternative would be an “owning borrow”, where you return a slice that has permission to treat the referenced data like it owns it (because it does), but those are still imperfect.

Required Methods

fn contiguous(&self) -> &[Self::Output]

Get the contiguous backing of this slice.

The returned slice should behave exactly like this one, e.g. self.get(n) == self.contiguous().get(n).

Examples

let a = [1, 2, 3].to_vec();
let b = a.contiguous();

assert_eq!(a, b);

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl<S> ContiguousBorrowed for &S

where S: ContiguousBorrowed + ?Sized,

fn contiguous(&self) -> &[S::Output]

impl<S> ContiguousBorrowed for &mut S

where S: ContiguousBorrowed + ?Sized,

fn contiguous(&self) -> &[S::Output]

impl<T> ContiguousBorrowed for [T]

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

impl<T, const N: usize> ContiguousBorrowed for [T; N]

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

Implementors