[][src]Trait erased_serde::Serializer

pub trait Serializer {
    fn erased_serialize_bool(&mut self, _: bool) -> Result<Ok, Error>;
fn erased_serialize_i8(&mut self, _: i8) -> Result<Ok, Error>;
fn erased_serialize_i16(&mut self, _: i16) -> Result<Ok, Error>;
fn erased_serialize_i32(&mut self, _: i32) -> Result<Ok, Error>;
fn erased_serialize_i64(&mut self, _: i64) -> Result<Ok, Error>;
fn erased_serialize_u8(&mut self, _: u8) -> Result<Ok, Error>;
fn erased_serialize_u16(&mut self, _: u16) -> Result<Ok, Error>;
fn erased_serialize_u32(&mut self, _: u32) -> Result<Ok, Error>;
fn erased_serialize_u64(&mut self, _: u64) -> Result<Ok, Error>;
fn erased_serialize_i128(&mut self, _: i128) -> Result<Ok, Error>;
fn erased_serialize_u128(&mut self, _: u128) -> Result<Ok, Error>;
fn erased_serialize_f32(&mut self, _: f32) -> Result<Ok, Error>;
fn erased_serialize_f64(&mut self, _: f64) -> Result<Ok, Error>;
fn erased_serialize_char(&mut self, _: char) -> Result<Ok, Error>;
fn erased_serialize_str(&mut self, _: &str) -> Result<Ok, Error>;
fn erased_serialize_bytes(&mut self, _: &[u8]) -> Result<Ok, Error>;
fn erased_serialize_none(&mut self) -> Result<Ok, Error>;
fn erased_serialize_some(&mut self, _: &dyn Serialize) -> Result<Ok, Error>;
fn erased_serialize_unit(&mut self) -> Result<Ok, Error>;
fn erased_serialize_unit_struct(
        &mut self,
        name: &'static str
    ) -> Result<Ok, Error>;
fn erased_serialize_unit_variant(
        &mut self,
        name: &'static str,
        variant_index: u32,
        variant: &'static str
    ) -> Result<Ok, Error>;
fn erased_serialize_newtype_struct(
        &mut self,
        name: &'static str,
        _: &dyn Serialize
    ) -> Result<Ok, Error>;
fn erased_serialize_newtype_variant(
        &mut self,
        name: &'static str,
        variant_index: u32,
        variant: &'static str,
        _: &dyn Serialize
    ) -> Result<Ok, Error>;
fn erased_serialize_seq(&mut self, len: Option<usize>) -> Result<Seq, Error>;
fn erased_serialize_tuple(&mut self, len: usize) -> Result<Tuple, Error>;
fn erased_serialize_tuple_struct(
        &mut self,
        name: &'static str,
        len: usize
    ) -> Result<TupleStruct, Error>;
fn erased_serialize_tuple_variant(
        &mut self,
        name: &'static str,
        variant_index: u32,
        variant: &'static str,
        len: usize
    ) -> Result<TupleVariant, Error>;
fn erased_serialize_map(&mut self, len: Option<usize>) -> Result<Map, Error>;
fn erased_serialize_struct(
        &mut self,
        name: &'static str,
        len: usize
    ) -> Result<Struct, Error>;
fn erased_serialize_struct_variant(
        &mut self,
        name: &'static str,
        variant_index: u32,
        variant: &'static str,
        len: usize
    ) -> Result<StructVariant, Error>;
fn erased_is_human_readable(&self) -> bool; }

An object-safe equivalent of Serde's Serializer trait.

Any implementation of Serde's Serializer can be converted to an &erased_serde::Serializer or Box<erased_serde::Serializer> trait object using erased_serde::Serializer::erase.

extern crate erased_serde;
extern crate serde_json;
extern crate serde_cbor;

use std::collections::BTreeMap as Map;
use std::io;

use erased_serde::{Serialize, Serializer};

fn main() {
    // Construct some serializers.
    let json = &mut serde_json::ser::Serializer::new(io::stdout());
    let cbor = &mut serde_cbor::ser::Serializer::new(io::stdout());

    // The values in this map are boxed trait objects. Ordinarily this would not
    // be possible with serde::Serializer because of object safety, but type
    // erasure makes it possible with erased_serde::Serializer.
    let mut formats: Map<&str, Box<Serializer>> = Map::new();
    formats.insert("json", Box::new(Serializer::erase(json)));
    formats.insert("cbor", Box::new(Serializer::erase(cbor)));

    // These are boxed trait objects as well. Same thing here - type erasure
    // makes this possible.
    let mut values: Map<&str, Box<Serialize>> = Map::new();
    values.insert("vec", Box::new(vec!["a", "b"]));
    values.insert("int", Box::new(65536));

    // Pick a Serializer out of the formats map.
    let format = formats.get_mut("json").unwrap();

    // Pick a Serialize out of the values map.
    let value = values.get("vec").unwrap();

    // This line prints `["a","b"]` to stdout.
    value.erased_serialize(format).unwrap();
}

Required methods

fn erased_serialize_bool(&mut self, _: bool) -> Result<Ok, Error>

fn erased_serialize_i8(&mut self, _: i8) -> Result<Ok, Error>

fn erased_serialize_i16(&mut self, _: i16) -> Result<Ok, Error>

fn erased_serialize_i32(&mut self, _: i32) -> Result<Ok, Error>

fn erased_serialize_i64(&mut self, _: i64) -> Result<Ok, Error>

fn erased_serialize_u8(&mut self, _: u8) -> Result<Ok, Error>

fn erased_serialize_u16(&mut self, _: u16) -> Result<Ok, Error>

fn erased_serialize_u32(&mut self, _: u32) -> Result<Ok, Error>

fn erased_serialize_u64(&mut self, _: u64) -> Result<Ok, Error>

fn erased_serialize_i128(&mut self, _: i128) -> Result<Ok, Error>

fn erased_serialize_u128(&mut self, _: u128) -> Result<Ok, Error>

fn erased_serialize_f32(&mut self, _: f32) -> Result<Ok, Error>

fn erased_serialize_f64(&mut self, _: f64) -> Result<Ok, Error>

fn erased_serialize_char(&mut self, _: char) -> Result<Ok, Error>

fn erased_serialize_str(&mut self, _: &str) -> Result<Ok, Error>

fn erased_serialize_bytes(&mut self, _: &[u8]) -> Result<Ok, Error>

fn erased_serialize_none(&mut self) -> Result<Ok, Error>

fn erased_serialize_some(&mut self, _: &dyn Serialize) -> Result<Ok, Error>

fn erased_serialize_unit(&mut self) -> Result<Ok, Error>

fn erased_serialize_unit_struct(
    &mut self,
    name: &'static str
) -> Result<Ok, Error>

fn erased_serialize_unit_variant(
    &mut self,
    name: &'static str,
    variant_index: u32,
    variant: &'static str
) -> Result<Ok, Error>

fn erased_serialize_newtype_struct(
    &mut self,
    name: &'static str,
    _: &dyn Serialize
) -> Result<Ok, Error>

fn erased_serialize_newtype_variant(
    &mut self,
    name: &'static str,
    variant_index: u32,
    variant: &'static str,
    _: &dyn Serialize
) -> Result<Ok, Error>

fn erased_serialize_seq(&mut self, len: Option<usize>) -> Result<Seq, Error>

fn erased_serialize_tuple(&mut self, len: usize) -> Result<Tuple, Error>

fn erased_serialize_tuple_struct(
    &mut self,
    name: &'static str,
    len: usize
) -> Result<TupleStruct, Error>

fn erased_serialize_tuple_variant(
    &mut self,
    name: &'static str,
    variant_index: u32,
    variant: &'static str,
    len: usize
) -> Result<TupleVariant, Error>

fn erased_serialize_map(&mut self, len: Option<usize>) -> Result<Map, Error>

fn erased_serialize_struct(
    &mut self,
    name: &'static str,
    len: usize
) -> Result<Struct, Error>

fn erased_serialize_struct_variant(
    &mut self,
    name: &'static str,
    variant_index: u32,
    variant: &'static str,
    len: usize
) -> Result<StructVariant, Error>

fn erased_is_human_readable(&self) -> bool

Loading content...

Methods

impl dyn Serializer[src]

pub fn erase<S>(serializer: S) -> Serializer<S> where
    S: Serializer,
    S::Ok: 'static, 
[src]

Convert any Serde Serializer to a trait object.

extern crate erased_serde;
extern crate serde_json;
extern crate serde_cbor;

use std::collections::BTreeMap as Map;
use std::io;

use erased_serde::{Serialize, Serializer};

fn main() {
    // Construct some serializers.
    let json = &mut serde_json::ser::Serializer::new(io::stdout());
    let cbor = &mut serde_cbor::ser::Serializer::new(io::stdout());

    // The values in this map are boxed trait objects. Ordinarily this would not
    // be possible with serde::Serializer because of object safety, but type
    // erasure makes it possible with erased_serde::Serializer.
    let mut formats: Map<&str, Box<Serializer>> = Map::new();
    formats.insert("json", Box::new(Serializer::erase(json)));
    formats.insert("cbor", Box::new(Serializer::erase(cbor)));

    // These are boxed trait objects as well. Same thing here - type erasure
    // makes this possible.
    let mut values: Map<&str, Box<Serialize>> = Map::new();
    values.insert("vec", Box::new(vec!["a", "b"]));
    values.insert("int", Box::new(65536));

    // Pick a Serializer out of the formats map.
    let format = formats.get_mut("json").unwrap();

    // Pick a Serialize out of the values map.
    let value = values.get("vec").unwrap();

    // This line prints `["a","b"]` to stdout.
    value.erased_serialize(format).unwrap();
}

Trait Implementations

impl<'a> Serializer for &'a mut dyn Serializer[src]

type Ok = Ok

The output type produced by this Serializer during successful serialization. Most serializers that produce text or binary output should set Ok = () and serialize into an [io::Write] or buffer contained within the Serializer instance. Serializers that build in-memory data structures may be simplified by using Ok to propagate the data structure around. Read more

type Error = Error

The error type when some error occurs during serialization.

type SerializeSeq = Seq<'a>

Type returned from [serialize_seq] for serializing the content of the sequence. Read more

type SerializeTuple = Tuple<'a>

Type returned from [serialize_tuple] for serializing the content of the tuple. Read more

type SerializeTupleStruct = TupleStruct<'a>

Type returned from [serialize_tuple_struct] for serializing the content of the tuple struct. Read more

type SerializeTupleVariant = TupleVariant<'a>

Type returned from [serialize_tuple_variant] for serializing the content of the tuple variant. Read more

type SerializeMap = Map<'a>

Type returned from [serialize_map] for serializing the content of the map. Read more

type SerializeStruct = Struct<'a>

Type returned from [serialize_struct] for serializing the content of the struct. Read more

type SerializeStructVariant = StructVariant<'a>

Type returned from [serialize_struct_variant] for serializing the content of the struct variant. Read more

fn collect_seq<I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
    I: IntoIterator,
    <I as IntoIterator>::Item: Serialize
[src]

Collect an iterator as a sequence. Read more

fn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
    I: IntoIterator<Item = (K, V)>,
    K: Serialize,
    V: Serialize
[src]

Collect an iterator as a map. Read more

fn collect_str<T>(self, value: &T) -> Result<Self::Ok, Self::Error> where
    T: Display + ?Sized
[src]

Serialize a string produced by an implementation of Display. Read more

impl<'a> Serializer for &'a mut (dyn Serializer + Send)[src]

type Ok = Ok

The output type produced by this Serializer during successful serialization. Most serializers that produce text or binary output should set Ok = () and serialize into an [io::Write] or buffer contained within the Serializer instance. Serializers that build in-memory data structures may be simplified by using Ok to propagate the data structure around. Read more

type Error = Error

The error type when some error occurs during serialization.

type SerializeSeq = Seq<'a>

Type returned from [serialize_seq] for serializing the content of the sequence. Read more

type SerializeTuple = Tuple<'a>

Type returned from [serialize_tuple] for serializing the content of the tuple. Read more

type SerializeTupleStruct = TupleStruct<'a>

Type returned from [serialize_tuple_struct] for serializing the content of the tuple struct. Read more

type SerializeTupleVariant = TupleVariant<'a>

Type returned from [serialize_tuple_variant] for serializing the content of the tuple variant. Read more

type SerializeMap = Map<'a>

Type returned from [serialize_map] for serializing the content of the map. Read more

type SerializeStruct = Struct<'a>

Type returned from [serialize_struct] for serializing the content of the struct. Read more

type SerializeStructVariant = StructVariant<'a>

Type returned from [serialize_struct_variant] for serializing the content of the struct variant. Read more

fn collect_seq<I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
    I: IntoIterator,
    <I as IntoIterator>::Item: Serialize
[src]

Collect an iterator as a sequence. Read more

fn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
    I: IntoIterator<Item = (K, V)>,
    K: Serialize,
    V: Serialize
[src]

Collect an iterator as a map. Read more

fn collect_str<T>(self, value: &T) -> Result<Self::Ok, Self::Error> where
    T: Display + ?Sized
[src]

Serialize a string produced by an implementation of Display. Read more

impl<'a> Serializer for &'a mut (dyn Serializer + Sync)[src]

type Ok = Ok

The output type produced by this Serializer during successful serialization. Most serializers that produce text or binary output should set Ok = () and serialize into an [io::Write] or buffer contained within the Serializer instance. Serializers that build in-memory data structures may be simplified by using Ok to propagate the data structure around. Read more

type Error = Error

The error type when some error occurs during serialization.

type SerializeSeq = Seq<'a>

Type returned from [serialize_seq] for serializing the content of the sequence. Read more

type SerializeTuple = Tuple<'a>

Type returned from [serialize_tuple] for serializing the content of the tuple. Read more

type SerializeTupleStruct = TupleStruct<'a>

Type returned from [serialize_tuple_struct] for serializing the content of the tuple struct. Read more

type SerializeTupleVariant = TupleVariant<'a>

Type returned from [serialize_tuple_variant] for serializing the content of the tuple variant. Read more

type SerializeMap = Map<'a>

Type returned from [serialize_map] for serializing the content of the map. Read more

type SerializeStruct = Struct<'a>

Type returned from [serialize_struct] for serializing the content of the struct. Read more

type SerializeStructVariant = StructVariant<'a>

Type returned from [serialize_struct_variant] for serializing the content of the struct variant. Read more

fn collect_seq<I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
    I: IntoIterator,
    <I as IntoIterator>::Item: Serialize
[src]

Collect an iterator as a sequence. Read more

fn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
    I: IntoIterator<Item = (K, V)>,
    K: Serialize,
    V: Serialize
[src]

Collect an iterator as a map. Read more

fn collect_str<T>(self, value: &T) -> Result<Self::Ok, Self::Error> where
    T: Display + ?Sized
[src]

Serialize a string produced by an implementation of Display. Read more

impl<'a> Serializer for &'a mut (dyn Serializer + Send + Sync)[src]

type Ok = Ok

The output type produced by this Serializer during successful serialization. Most serializers that produce text or binary output should set Ok = () and serialize into an [io::Write] or buffer contained within the Serializer instance. Serializers that build in-memory data structures may be simplified by using Ok to propagate the data structure around. Read more

type Error = Error

The error type when some error occurs during serialization.

type SerializeSeq = Seq<'a>

Type returned from [serialize_seq] for serializing the content of the sequence. Read more

type SerializeTuple = Tuple<'a>

Type returned from [serialize_tuple] for serializing the content of the tuple. Read more

type SerializeTupleStruct = TupleStruct<'a>

Type returned from [serialize_tuple_struct] for serializing the content of the tuple struct. Read more

type SerializeTupleVariant = TupleVariant<'a>

Type returned from [serialize_tuple_variant] for serializing the content of the tuple variant. Read more

type SerializeMap = Map<'a>

Type returned from [serialize_map] for serializing the content of the map. Read more

type SerializeStruct = Struct<'a>

Type returned from [serialize_struct] for serializing the content of the struct. Read more

type SerializeStructVariant = StructVariant<'a>

Type returned from [serialize_struct_variant] for serializing the content of the struct variant. Read more

fn collect_seq<I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
    I: IntoIterator,
    <I as IntoIterator>::Item: Serialize
[src]

Collect an iterator as a sequence. Read more

fn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
    I: IntoIterator<Item = (K, V)>,
    K: Serialize,
    V: Serialize
[src]

Collect an iterator as a map. Read more

fn collect_str<T>(self, value: &T) -> Result<Self::Ok, Self::Error> where
    T: Display + ?Sized
[src]

Serialize a string produced by an implementation of Display. Read more

Implementations on Foreign Types

impl<'a> Serializer for Box<dyn Serializer + 'a>[src]

impl<'a> Serializer for Box<dyn Serializer + Send + 'a>[src]

impl<'a> Serializer for Box<dyn Serializer + Sync + 'a>[src]

impl<'a> Serializer for Box<dyn Serializer + Send + Sync + 'a>[src]

impl<'a, T: ?Sized + Serializer> Serializer for &'a mut T[src]

Loading content...

Implementors

Loading content...