Trait Octets

pub trait Octets: AsRef<[u8]> {
    type Range<'a>: Octets
       where Self: 'a;

    // Required method
    fn range(&self, range: impl RangeBounds<usize>) -> Self::Range<'_>;
}

A type representing an octets sequence.

The primary purpose of the trait is to allow access to a sub-sequence, called a ‘range.’ The type of this range is given via the Range associated type. For most types it will be a &[u8] with a lifetime equal to that of a reference. Only if an owned range can be created cheaply, it should be that type.

Required Associated Types

type Range<'a>: Octets where Self: 'a

Required Methods

fn range(&self, range: impl RangeBounds<usize>) -> Self::Range<'_>

Returns a sub-sequence or ‘range’ of the sequence.

Panics

The method should panic if start or end are greater than the length of the octets sequence or if start is greater than end.

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 Octets for Bytes

type Range<'a> = Bytes

fn range(&self, range: impl RangeBounds<usize>) -> Self::Range<'_>

impl Octets for Arc<[u8]>

type Range<'a> = &'a [u8]

fn range(&self, range: impl RangeBounds<usize>) -> Self::Range<'_>

impl Octets for Vec<u8>

type Range<'a> = &'a [u8]

fn range(&self, range: impl RangeBounds<usize>) -> Self::Range<'_>

impl Octets for [u8]

type Range<'a> = &'a [u8]

fn range(&self, range: impl RangeBounds<usize>) -> Self::Range<'_>

impl<'c> Octets for Cow<'c, [u8]>

type Range<'a> = &'a [u8] where Self: 'a

fn range(&self, range: impl RangeBounds<usize>) -> Self::Range<'_>

impl<'t, T: Octets + ?Sized> Octets for &'t T

type Range<'a> = <T as Octets>::Range<'t> where Self: 'a

fn range(&self, range: impl RangeBounds<usize>) -> Self::Range<'_>

impl<A: Array<Item = u8>> Octets for SmallVec<A>

type Range<'a> = &'a [u8] where A: 'a

fn range(&self, range: impl RangeBounds<usize>) -> Self::Range<'_>

Implementors

impl<const N: usize> Octets for Array<N>

type Range<'a> = &'a [u8]