Trait rkyv_dyn::DynSerializer

pub trait DynSerializer {
    fn pos_dyn(&self) -> usize;
    fn write_dyn(&mut self, bytes: &[u8]) -> Result<(), DynError>;
    unsafe fn push_scratch_dyn(
        &mut self, 
        layout: Layout
    ) -> Result<NonNull<[u8]>, DynError>;
    unsafe fn pop_scratch_dyn(
        &mut self, 
        ptr: NonNull<u8>, 
        layout: Layout
    ) -> Result<(), DynError>;
}

An object-safe version of Serializer.

Instead of an associated error type, DynSerializer returns the DynError type. If you have a serializer that already implements Serializer, then it will automatically implement DynSerializer.

Required methods

fn pos_dyn(&self) -> usize

Returns the current position of the serializer.

fn write_dyn(&mut self, bytes: &[u8]) -> Result<(), DynError>

Attempts to write the given bytes to the serializer.

unsafe fn push_scratch_dyn(
    &mut self,
    layout: Layout
) -> Result<NonNull<[u8]>, DynError>

Allocates scratch space of the requested size.

Safety

layout must have non-zero size.

unsafe fn pop_scratch_dyn(
    &mut self,
    ptr: NonNull<u8>,
    layout: Layout
) -> Result<(), DynError>

Deallocates previously allocated scratch space.

Safety

• ptr must be the scratch memory last allocated with push_scratch.
• layout must be the same layout that was used to allocate that block of memory.

Trait Implementations

impl<'a> Fallible for dyn DynSerializer + 'a

type Error = DynError

The error produced by any failing methods.

impl<'a> ScratchSpace for dyn DynSerializer + 'a

unsafe fn push_scratch(
    &mut self,
    layout: Layout
) -> Result<NonNull<[u8]>, Self::Error>

Allocates scratch space of the requested size.

unsafe fn pop_scratch(
    &mut self,
    ptr: NonNull<u8>,
    layout: Layout
) -> Result<(), Self::Error>

Deallocates previously allocated scratch space.

impl<'a> Serializer for dyn DynSerializer + 'a

fn pos(&self) -> usize

Returns the current position of the serializer.

fn write(&mut self, bytes: &[u8]) -> Result<(), Self::Error>

Attempts to write the given bytes to the serializer.

fn pad(&mut self, padding: usize) -> Result<(), Self::Error>

Advances the given number of bytes as padding.

fn align(&mut self, align: usize) -> Result<usize, Self::Error>

Aligns the position of the serializer to the given alignment.

fn align_for<T>(&mut self) -> Result<usize, Self::Error>

Aligns the position of the serializer to be suitable to write the given type.

unsafe fn resolve_aligned<T>(
    &mut self,
    value: &T,
    resolver: <T as Archive>::Resolver
) -> Result<usize, Self::Error> where
    T: Archive + ?Sized, 

Resolves the given value with its resolver and writes the archived type.

fn serialize_value<T>(&mut self, value: &T) -> Result<usize, Self::Error> where
    T: Serialize<Self>, 

Archives the given object and returns the position it was archived at.

unsafe fn resolve_unsized_aligned<T>(
    &mut self,
    value: &T,
    to: usize,
    metadata_resolver: <T as ArchiveUnsized>::MetadataResolver
) -> Result<usize, Self::Error> where
    T: ArchiveUnsized + ?Sized, 

Resolves the given reference with its resolver and writes the archived reference.

fn serialize_unsized_value<T>(
    &mut self,
    value: &T
) -> Result<usize, Self::Error> where
    T: SerializeUnsized<Self> + ?Sized, 

Archives a reference to the given object and returns the position it was archived at.

Implementations on Foreign Types

impl<S: ScratchSpace + Serializer + ?Sized> DynSerializer for &mut S

fn pos_dyn(&self) -> usize

fn write_dyn(&mut self, bytes: &[u8]) -> Result<(), DynError>

unsafe fn push_scratch_dyn(
    &mut self,
    layout: Layout
) -> Result<NonNull<[u8]>, DynError>

unsafe fn pop_scratch_dyn(
    &mut self,
    ptr: NonNull<u8>,
    layout: Layout
) -> Result<(), DynError>

Implementors