Struct Owned 

pub struct Owned<Y: for<'a> Yokeable<'a>> { /* private fields */ }

An owned, 'static, Send + Sync bundle of (backing bytes, parsed view).

Y is the view type with its lifetime set to 'static — e.g. Owned<Pmt<'static>>, Owned<Sdt<'static>>, Owned<DescriptorLoop<'static>>. The backing buffer is an Arc<[u8]>, so Clone is a refcount bump and the view is shared, never re-parsed.

Construct one with Owned::try_new (fallible parse) or Owned::new (infallible), then read the borrowing view with Owned::get.

Implementations

impl<Y: for<'a> Yokeable<'a>> Owned<Y>

pub fn try_new<F, E>(bytes: Arc<[u8]>, parse: F) -> Result<Self, E>

where F: for<'a> FnOnce(&'a [u8]) -> Result<<Y as Yokeable<'a>>::Output, E>,

Parse bytes into a view and bundle the two into an Owned.

parse receives a borrow of the backing bytes and returns the borrowing view (or an error). The borrow does not escape parse: yoke re-binds the view’s lifetime to the Arc<[u8]> it now co-owns.

Errors

Returns parse’s error verbatim if parsing fails.

pub fn new<F>(bytes: Arc<[u8]>, parse: F) -> Self

where F: for<'a> FnOnce(&'a [u8]) -> <Y as Yokeable<'a>>::Output,

Parse bytes into a view with an infallible parser and bundle them.

pub fn get(&self) -> &<Y as Yokeable<'_>>::Output

Borrow the parsed view. No re-parse; this is a field read.

pub fn backing_bytes(&self) -> &[u8]

The backing section bytes the view borrows from.

Trait Implementations

impl<Y: for<'a> Yokeable<'a>> Clone for Owned<Y>

where for<'a> YokeTraitHack<<Y as Yokeable<'a>>::Output>: Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Y> Debug for Owned<Y>

where Y: for<'a> Yokeable<'a>, for<'a> <Y as Yokeable<'a>>::Output: Debug,

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

Formats the value using the given formatter.