Struct rkyv::with::CopyOptimize

pub struct CopyOptimize;

A wrapper that provides specialized, performant implementations of serialization and deserialization.

This wrapper can be used with containers like Vec, but care must be taken to ensure that they contain copy-safe types. Copy-safe types must be trivially copyable (have the same archived and unarchived representations) and contain no padding bytes. In situations where copying uninitialized bytes the output is acceptable, this wrapper may be used with containers of types that contain padding bytes.

Safety

Using this wrapper with containers containing non-copy-safe types may result in undefined behavior.

Example

use rkyv::{Archive, with::CopyOptimize};

#[derive(Archive)]
struct Example {
    #[with(CopyOptimize)]
    bytes: Vec<u8>,
}

Trait Implementations

impl<T: Archive> ArchiveWith<Box<[T]>> for CopyOptimize

type Archived = ArchivedBox<[<T as Archive>::Archived]>

The archived type of a With<F, Self>.

type Resolver = BoxResolver<<[T] as ArchiveUnsized>::MetadataResolver>

The resolver of a With<F, Self>.

unsafe fn resolve_with( field: &Box<[T]>, pos: usize, resolver: Self::Resolver, out: *mut Self::Archived, )

Resolves the archived type using a reference to the field type F.

impl<T: Archive> ArchiveWith<Vec<T>> for CopyOptimize

type Archived = ArchivedVec<<T as Archive>::Archived>

The archived type of a With<F, Self>.

type Resolver = VecResolver

The resolver of a With<F, Self>.

unsafe fn resolve_with( field: &Vec<T>, pos: usize, resolver: Self::Resolver, out: *mut Self::Archived, )

Resolves the archived type using a reference to the field type F.

impl<'a, T: Archive> ArchiveWith<With<&'a [T], RefAsBox>> for CopyOptimize

type Archived = ArchivedBox<[<T as Archive>::Archived]>

The archived type of a With<F, Self>.

type Resolver = BoxResolver<<[T] as ArchiveUnsized>::MetadataResolver>

The resolver of a With<F, Self>.

unsafe fn resolve_with( field: &With<&'a [T], RefAsBox>, pos: usize, resolver: Self::Resolver, out: *mut Self::Archived, )

Resolves the archived type using a reference to the field type F.

impl Debug for CopyOptimize

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

Formats the value using the given formatter.

impl<T, D> DeserializeWith<ArchivedBox<[<T as Archive>::Archived]>, Box<[T]>, D> for CopyOptimize

where T: Archive, T::Archived: Deserialize<T, D>, D: Fallible + ?Sized,

fn deserialize_with( field: &ArchivedBox<[T::Archived]>, _: &mut D, ) -> Result<Box<[T]>, D::Error>

Deserializes the field type F using the given deserializer.

impl<T, D> DeserializeWith<ArchivedVec<<T as Archive>::Archived>, Vec<T>, D> for CopyOptimize

where T: Archive, T::Archived: Deserialize<T, D>, D: Fallible + ?Sized,

fn deserialize_with( field: &ArchivedVec<T::Archived>, _: &mut D, ) -> Result<Vec<T>, D::Error>

Deserializes the field type F using the given deserializer.

impl<T, S> SerializeWith<Box<[T]>, S> for CopyOptimize

where T: Serialize<S>, S: Serializer + ?Sized,

fn serialize_with( field: &Box<[T]>, serializer: &mut S, ) -> Result<Self::Resolver, S::Error>

Serializes the field type F using the given serializer.

impl<T, S> SerializeWith<Vec<T>, S> for CopyOptimize

where T: Serialize<S>, S: Serializer + ?Sized,

fn serialize_with( field: &Vec<T>, serializer: &mut S, ) -> Result<Self::Resolver, S::Error>

Serializes the field type F using the given serializer.

impl<'a, T, S> SerializeWith<With<&'a [T], RefAsBox>, S> for CopyOptimize

where T: Serialize<S>, S: Serializer + ?Sized,

fn serialize_with( field: &With<&'a [T], RefAsBox>, serializer: &mut S, ) -> Result<Self::Resolver, S::Error>

Serializes the field type F using the given serializer.