Enum Chunk 

pub enum Chunk<'a> {
    Atom(Atom<'a>),
    Struct(Boxed<dyn StructEmitter + 'a>),
    Map(Boxed<dyn MapEmitter + 'a>),
    Seq(Boxed<dyn SeqEmitter + 'a>),
    Forward(SerializeHandle<'a>),
}

A chunk represents the minimum state necessary to serialize a value.

Chunks are of two types: atomic primitives and stateful emitters. For instance Chunk::Bool(true) is an atomic primitive. It can be emitted to a serializer directly. On the other hand a Chunk::Map contains a stateful emitter that keeps yielding values until it’s done walking over the map.

The emitters are typically allocated in the arena of the serialization with Chunk::seq, Chunk::map and Chunk::structure (see Boxed).

Variants

Atom(Atom<'a>)

Struct(Boxed<dyn StructEmitter + 'a>)

Map(Boxed<dyn MapEmitter + 'a>)

Seq(Boxed<dyn SeqEmitter + 'a>)

Forward(SerializeHandle<'a>)

Serializes another value in place of this one.

The driver serializes the value in the handle as if it was produced instead of the value that returned the chunk. This is useful to serialize a value by converting it into another value first as the handle can own that value:

use deser::ser::{Chunk, Serialize, SerializeHandle};
use deser::{Error, State};

struct Point(u32, u32);

impl Serialize for Point {
    fn serialize(&self, state: &mut State) -> Result<Chunk<'_>, Error> {
        // serialize as a vector
        Ok(Chunk::Forward(SerializeHandle::arena(
            vec![self.0, self.1],
            state,
        )))
    }
}

The container_shape of the value that returned the chunk is not used, the forwarded value provides its own. finish is invoked on the forwarded value first and then on the value that returned the chunk.

Forwarding chunks cannot be flattened into structs.

Implementations

impl<'a> Chunk<'a>

pub fn seq<E: SeqEmitter + 'a>(emitter: E, state: &mut State) -> Chunk<'a>

Creates a chunk of a sequence emitter in the arena of the serialization.

pub fn map<E: MapEmitter + 'a>(emitter: E, state: &mut State) -> Chunk<'a>

Creates a chunk of a map emitter in the arena of the serialization.

pub fn structure<E: StructEmitter + 'a>( emitter: E, state: &mut State, ) -> Chunk<'a>

Creates a chunk of a struct emitter in the arena of the serialization.

Trait Implementations

impl<'a> From<&'a [u8]> for Chunk<'a>

fn from(value: &'a [u8]) -> Chunk<'a>

Converts to this type from the input type.

impl<'a> From<&'a str> for Chunk<'a>

fn from(value: &'a str) -> Chunk<'a>

Converts to this type from the input type.

impl From<()> for Chunk<'static>

fn from(_: ()) -> Chunk<'static>

Converts to this type from the input type.

impl<'a> From<Atom<'a>> for Chunk<'a>

fn from(atom: Atom<'a>) -> Self

Converts to this type from the input type.

impl From<String> for Chunk<'static>

fn from(value: String) -> Chunk<'static>

Converts to this type from the input type.

impl From<bool> for Chunk<'static>

fn from(value: bool) -> Self

Converts to this type from the input type.

impl From<char> for Chunk<'static>

fn from(value: char) -> Self

Converts to this type from the input type.

impl From<f32> for Chunk<'static>

fn from(value: f32) -> Self

Converts to this type from the input type.

impl From<f64> for Chunk<'static>

fn from(value: f64) -> Self

Converts to this type from the input type.

impl From<i64> for Chunk<'static>

fn from(value: i64) -> Self

Converts to this type from the input type.

impl From<isize> for Chunk<'static>

fn from(value: isize) -> Self

Converts to this type from the input type.

impl From<u64> for Chunk<'static>

fn from(value: u64) -> Self

Converts to this type from the input type.

impl From<usize> for Chunk<'static>

fn from(value: usize) -> Self

Converts to this type from the input type.