Struct DataView

pub struct DataView<T, D = AlignedVec>
where
    T: Archive,
    T::Archived: 'static,
    D: Deref<Target = [u8]> + Send + Sync,
{ /* private fields */ }

A block of data that can be accessed as if it is the archived value T.

This allows for safe, true zero-copy deserialization avoiding unnecessary allocations if the situation does not require having an owned version of the value.

Implementations

impl<T, D> DataView<T, D>

where T: Archive, T::Archived: CheckBytes<DefaultValidator<'static>> + 'static, D: Deref<Target = [u8]> + Send + Sync,

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

Gets the bytes representation of the dataview.

pub fn into_data(self) -> D

Consumes the bytes representation of the dataview.

impl<T, D> DataView<T, D>

where T: Archive, T::Archived: Deserialize<T, SharedDeserializeMap> + 'static, D: Deref<Target = [u8]> + Send + Sync,

pub fn to_owned(&self) -> Result<T, InvalidView>

Deserializes the view into it’s owned value T.

Trait Implementations

impl<T, D> Clone for DataView<T, D>

where T: Archive, T::Archived: CheckBytes<DefaultValidator<'static>> + Debug, D: Deref<Target = [u8]> + Send + Sync + Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, D> Debug for DataView<T, D>

where T: Archive, T::Archived: CheckBytes<DefaultValidator<'static>> + Debug, D: Deref<Target = [u8]> + Send + Sync,

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

Formats the value using the given formatter.

impl<T, D> Deref for DataView<T, D>

where T: Archive, T::Archived: CheckBytes<DefaultValidator<'static>>, D: Deref<Target = [u8]> + Send + Sync,

type Target = <T as Archive>::Archived

The resulting type after dereferencing.

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

Dereferences the value.

impl<T, D> PartialEq<T> for DataView<T, D>

where T: Archive, T::Archived: CheckBytes<DefaultValidator<'static>> + PartialEq<T>, D: Deref<Target = [u8]> + Send + Sync,

fn eq(&self, other: &T) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T, D> PartialEq for DataView<T, D>

where T: Archive, T::Archived: CheckBytes<DefaultValidator<'static>> + PartialEq, D: Deref<Target = [u8]> + Send + Sync,

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.