Trait rkyv_dyn::DynSerializer

pub trait DynSerializer {
    // Required methods
    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 = Box<dyn Any>

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