Struct CompositeSerializer

pub struct CompositeSerializer<S = Infallible, C = Infallible, H = Infallible> { /* private fields */ }

A serializer built from composeable pieces.

Implementations

impl<S, C, H> CompositeSerializer<S, C, H>

pub fn new(serializer: S, scratch: C, shared: H) -> Self

Creates a new composite serializer from serializer, scratch, and shared components.

pub fn into_components(self) -> (S, C, H)

Consumes the composite serializer and returns the components.

pub fn into_serializer(self) -> S

Consumes the composite serializer and returns the serializer.

The scratch space and shared component are discarded.

Trait Implementations

impl<S: Debug, C: Debug, H: Debug> Debug for CompositeSerializer<S, C, H>

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

Formats the value using the given formatter.

impl<S: Default, C: Default, H: Default> Default for CompositeSerializer<S, C, H>

fn default() -> Self

Returns the “default value” for a type.

impl<S: Fallible, C: Fallible, H: Fallible> Fallible for CompositeSerializer<S, C, H>

type Error = CompositeSerializerError<<S as Fallible>::Error, <C as Fallible>::Error, <H as Fallible>::Error>

The error produced by any failing methods.

impl<S: Fallible, C: ScratchSpace, H: Fallible> ScratchSpace for CompositeSerializer<S, C, H>

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<S: Serializer, C: Fallible, H: Fallible> Serializer for CompositeSerializer<S, C, H>

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: Archive + ?Sized>( &mut self, value: &T, resolver: T::Resolver, ) -> Result<usize, Self::Error>

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

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

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

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

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

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

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

impl<S: Fallible, C: Fallible, H: SharedSerializeRegistry> SharedSerializeRegistry for CompositeSerializer<S, C, H>

fn get_shared_ptr(&self, value: *const u8) -> Option<usize>

Gets the position of a previously-added shared pointer.

fn add_shared_ptr( &mut self, value: *const u8, pos: usize, ) -> Result<(), Self::Error>

Adds the position of a shared pointer to the registry.

fn get_shared<T: ?Sized>(&self, value: &T) -> Option<usize>

Gets the position of a previously-added shared value.

fn add_shared<T: ?Sized>( &mut self, value: &T, pos: usize, ) -> Result<(), Self::Error>

Adds the position of a shared value to the registry.

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

where Self: Serializer,

Archives the given shared value and returns its position. If the value has already been added then it returns the position of the previously added value.