Struct msd::Serializer
source · [−]pub struct Serializer<W> { /* private fields */ }
Expand description
Serializes data into MSD format.
Serializer
can be used to write to any value that implements the Write
trait. The bytes
written will be valid MSD that can be read later using Deserializer
.
Example
use serde::Serialize;
use std::collections::BTreeMap;
let mut map: BTreeMap<String, u64> = BTreeMap::new();
map.insert("foo".to_owned(), 1);
map.insert("bar".to_owned(), 2);
let mut serialized = Vec::new();
let mut serializer = msd::Serializer::new(&mut serialized);
map.serialize(&mut serializer);
assert_eq!(serialized, b"#bar:2;\n#foo:1;\n");
Implementations
sourceimpl<W> Serializer<W>
impl<W> Serializer<W>
Trait Implementations
sourceimpl<'a, W> Serializer for &'a mut Serializer<W> where
W: Write,
impl<'a, W> Serializer for &'a mut Serializer<W> where
W: Write,
type Ok = ()
type 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 SerializeSeq = Serializer<'a, W>
type SerializeSeq = Serializer<'a, W>
Type returned from serialize_seq
for serializing the content of the
sequence. Read more
type SerializeTuple = Serializer<'a, W>
type SerializeTuple = Serializer<'a, W>
Type returned from serialize_tuple
for serializing the content of
the tuple. Read more
type SerializeTupleStruct = Serializer<'a, W>
type SerializeTupleStruct = Serializer<'a, W>
Type returned from serialize_tuple_struct
for serializing the
content of the tuple struct. Read more
type SerializeTupleVariant = Serializer<'a, W>
type SerializeTupleVariant = Serializer<'a, W>
Type returned from serialize_tuple_variant
for serializing the
content of the tuple variant. Read more
type SerializeMap = Serializer<'a, W>
type SerializeMap = Serializer<'a, W>
Type returned from serialize_map
for serializing the content of the
map. Read more
type SerializeStruct = Serializer<'a, W>
type SerializeStruct = Serializer<'a, W>
Type returned from serialize_struct
for serializing the content of
the struct. Read more
type SerializeStructVariant = Serializer<'a, W>
type SerializeStructVariant = Serializer<'a, W>
Type returned from serialize_struct_variant
for serializing the
content of the struct variant. Read more
sourcefn serialize_bytes(self, v: &[u8]) -> Result<Self::Ok>
fn serialize_bytes(self, v: &[u8]) -> Result<Self::Ok>
Serialize a chunk of raw byte data. Read more
sourcefn serialize_unit(self) -> Result<Self::Ok>
fn serialize_unit(self) -> Result<Self::Ok>
Serialize a ()
value. Read more
sourcefn serialize_unit_struct(self, _name: &'static str) -> Result<Self::Ok>
fn serialize_unit_struct(self, _name: &'static str) -> Result<Self::Ok>
Serialize a unit struct like struct Unit
or PhantomData<T>
. Read more
sourcefn serialize_unit_variant(
self,
_name: &'static str,
_variant_index: u32,
variant: &'static str
) -> Result<Self::Ok>
fn serialize_unit_variant(
self,
_name: &'static str,
_variant_index: u32,
variant: &'static str
) -> Result<Self::Ok>
Serialize a unit variant like E::A
in enum E { A, B }
. Read more
sourcefn serialize_newtype_struct<T>(
self,
_name: &'static str,
value: &T
) -> Result<Self::Ok> where
T: ?Sized + Serialize,
fn serialize_newtype_struct<T>(
self,
_name: &'static str,
value: &T
) -> Result<Self::Ok> where
T: ?Sized + Serialize,
Serialize a newtype struct like struct Millimeters(u8)
. Read more
sourcefn serialize_newtype_variant<T>(
self,
_name: &'static str,
_variant_index: u32,
variant: &'static str,
value: &T
) -> Result<Self::Ok> where
T: ?Sized + Serialize,
fn serialize_newtype_variant<T>(
self,
_name: &'static str,
_variant_index: u32,
variant: &'static str,
value: &T
) -> Result<Self::Ok> where
T: ?Sized + Serialize,
Serialize a newtype variant like E::N
in enum E { N(u8) }
. Read more
sourcefn serialize_seq(self, _len: Option<usize>) -> Result<Self::SerializeSeq>
fn serialize_seq(self, _len: Option<usize>) -> Result<Self::SerializeSeq>
Begin to serialize a variably sized sequence. This call must be
followed by zero or more calls to serialize_element
, then a call to
end
. Read more
sourcefn serialize_tuple(self, _len: usize) -> Result<Self::SerializeTuple>
fn serialize_tuple(self, _len: usize) -> Result<Self::SerializeTuple>
Begin to serialize a statically sized sequence whose length will be
known at deserialization time without looking at the serialized data.
This call must be followed by zero or more calls to serialize_element
,
then a call to end
. Read more
sourcefn serialize_tuple_struct(
self,
_name: &'static str,
_len: usize
) -> Result<Self::SerializeTupleStruct>
fn serialize_tuple_struct(
self,
_name: &'static str,
_len: usize
) -> Result<Self::SerializeTupleStruct>
Begin to serialize a tuple struct like struct Rgb(u8, u8, u8)
. This
call must be followed by zero or more calls to serialize_field
, then a
call to end
. Read more
sourcefn serialize_tuple_variant(
self,
_name: &'static str,
_variant_index: u32,
variant: &'static str,
_len: usize
) -> Result<Self::SerializeTupleVariant>
fn serialize_tuple_variant(
self,
_name: &'static str,
_variant_index: u32,
variant: &'static str,
_len: usize
) -> Result<Self::SerializeTupleVariant>
Begin to serialize a tuple variant like E::T
in enum E { T(u8, u8) }
. This call must be followed by zero or more calls to
serialize_field
, then a call to end
. Read more
sourcefn serialize_map(self, _len: Option<usize>) -> Result<Self::SerializeMap>
fn serialize_map(self, _len: Option<usize>) -> Result<Self::SerializeMap>
Begin to serialize a map. This call must be followed by zero or more
calls to serialize_key
and serialize_value
, then a call to end
. Read more
sourcefn serialize_struct(
self,
_name: &'static str,
_len: usize
) -> Result<Self::SerializeStruct>
fn serialize_struct(
self,
_name: &'static str,
_len: usize
) -> Result<Self::SerializeStruct>
Begin to serialize a struct like struct Rgb { r: u8, g: u8, b: u8 }
.
This call must be followed by zero or more calls to serialize_field
,
then a call to end
. Read more
sourcefn serialize_struct_variant(
self,
_name: &'static str,
_variant_index: u32,
variant: &'static str,
_len: usize
) -> Result<Self::SerializeStructVariant>
fn serialize_struct_variant(
self,
_name: &'static str,
_variant_index: u32,
variant: &'static str,
_len: usize
) -> Result<Self::SerializeStructVariant>
Begin to serialize a struct variant like E::S
in enum E { S { r: u8, g: u8, b: u8 } }
. This call must be followed by zero or more calls to
serialize_field
, then a call to end
. Read more
sourcefn collect_seq<I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
I: IntoIterator,
<I as IntoIterator>::Item: Serialize,
fn collect_seq<I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
I: IntoIterator,
<I as IntoIterator>::Item: Serialize,
Collect an iterator as a sequence. Read more
sourcefn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
K: Serialize,
V: Serialize,
I: IntoIterator<Item = (K, V)>,
fn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error> where
K: Serialize,
V: Serialize,
I: IntoIterator<Item = (K, V)>,
Collect an iterator as a map. Read more
sourcefn collect_str<T>(self, value: &T) -> Result<Self::Ok, Self::Error> where
T: Display + ?Sized,
fn collect_str<T>(self, value: &T) -> Result<Self::Ok, Self::Error> where
T: Display + ?Sized,
Serialize a string produced by an implementation of Display
. Read more
sourcefn is_human_readable(&self) -> bool
fn is_human_readable(&self) -> bool
Determine whether Serialize
implementations should serialize in
human-readable form. Read more
Auto Trait Implementations
impl<W> RefUnwindSafe for Serializer<W> where
W: RefUnwindSafe,
impl<W> Send for Serializer<W> where
W: Send,
impl<W> Sync for Serializer<W> where
W: Sync,
impl<W> Unpin for Serializer<W> where
W: Unpin,
impl<W> UnwindSafe for Serializer<W> where
W: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more