Struct ArcSliceBorrow 

pub struct ArcSliceBorrow<'a, S: Slice + ?Sized, L: Layout = DefaultLayout> { /* private fields */ }

A borrowed view of an ArcSlice.

ArcSliceBorrow is roughly equivalent to (&S, &ArcSlice<S, L>). A new ArcSlice instance can be obtained with clone_arc.
One advantage of using ArcSliceBorrow is that clone_arc doesn’t need to perform bound checks that was done at ArcSliceBorrow creation; using (&S, &ArcSlice<S, L>) however would require to check bounds a second time when using ArcSlice::subslice_from_ref.

When using ArcLayout, ArcSliceBorrow is even more efficient, because it can directly embed the internal Arc instead of an ArcSlice reference, saving one indirection.

Examples

use arc_slice::ArcSlice;

let s = ArcSlice::<[u8]>::from(b"hello world");
let borrow = s.borrow(..5);
assert_eq!(&borrow[..], b"hello");
let s2: ArcSlice<[u8]> = borrow.clone_arc();

Implementations

impl<'a, S: Slice + ?Sized, L: Layout> ArcSliceBorrow<'a, S, L>

pub fn try_clone_arc(self) -> Result<ArcSlice<S, L>, AllocError>

Tries cloning the ArcSliceBorrow into a subslice of the borrowed ArcSlice, returning an error if an allocation fails.

The returned ArcSlice has the same slice as the original borrow.

The operation may not allocate, see CloneNoAllocLayout documentation.

Examples

use arc_slice::ArcSlice;

let s = ArcSlice::<[u8]>::from(b"hello world");
let borrow = s.borrow(..5);
assert_eq!(&borrow[..], b"hello");
let s2: ArcSlice<[u8]> = borrow.try_clone_arc().unwrap();
assert_eq!(s2, b"hello");

pub fn as_slice(&self) -> &'a S

Returns the borrowed slice.

Roughly equivalent to &self[..], but using the borrow lifetime instead of self’s one.

Examples

use arc_slice::ArcSlice;

let s = ArcSlice::<[u8]>::from(b"hello world");
assert_eq!(s.as_slice(), b"hello world");

pub fn reborrow( &self, range: impl RangeBounds<usize>, ) -> ArcSliceBorrow<'a, S, L>

where S: Subsliceable,

Reborrows a subslice of an ArcSliceBorrow with a given range.

The range is applied to the ArcSliceBorrow slice, not to the underlying ArcSlice one.

Examples

use arc_slice::ArcSlice;

let s = ArcSlice::<[u8]>::from(b"hello world");
let borrow = s.borrow(..5);
assert_eq!(&borrow[..], b"hello");
let reborrow = borrow.reborrow(2..4);
assert_eq!(&reborrow[..], b"ll");

pub fn reborrow_from_ref(&self, subset: &S) -> ArcSliceBorrow<'a, S, L>

where S: Subsliceable,

Reborrows a subslice of an ArcSliceBorrow from a slice reference.

The slice reference must be contained into the ArcSliceBorrow slice, not into the underlying ArcSlice one.

Examples

use arc_slice::ArcSlice;

let s = ArcSlice::<[u8]>::from(b"hello world");
let hello = &s[..5];
let borrow = s.borrow_from_ref(hello);
assert_eq!(&borrow[..], b"hello");
let ll = &borrow[2..4];
let reborrow = borrow.reborrow_from_ref(ll);
assert_eq!(&reborrow[..], b"ll");

impl<S: Slice + ?Sized, L: Layout> ArcSliceBorrow<'_, S, L>

pub fn clone_arc(self) -> ArcSlice<S, L>

Clone the ArcSliceBorrow into a subslice of the borrowed ArcSlice.

The returned ArcSlice has the same slice as the original borrow.

Examples

use arc_slice::ArcSlice;

let s = ArcSlice::<[u8]>::from(b"hello world");
let borrow = s.borrow(..5);
assert_eq!(&borrow[..], b"hello");
let s2: ArcSlice<[u8]> = borrow.clone_arc();
assert_eq!(s2, b"hello");

Trait Implementations

impl<S: Slice + ?Sized, L: Layout> Clone for ArcSliceBorrow<'_, S, L>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + Slice + ?Sized, L: Layout> Debug for ArcSliceBorrow<'_, S, L>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S: Slice + ?Sized, L: Layout> Deref for ArcSliceBorrow<'_, S, L>

type Target = S

The resulting type after dereferencing.

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

Dereferences the value.

impl<S: Slice + ?Sized, L: Layout> Copy for ArcSliceBorrow<'_, S, L>

impl<S: Slice + ?Sized, L: Layout> Send for ArcSliceBorrow<'_, S, L>

impl<S: Slice + ?Sized, L: Layout> Sync for ArcSliceBorrow<'_, S, L>