Struct geng::prelude::toml::ser::Serializer
#[non_exhaustive]pub struct Serializer<'d> { /* private fields */ }
Expand description
Serialization for TOML documents.
This structure implements serialization support for TOML to serialize an arbitrary type to TOML. Note that the TOML format does not support all datatypes in Rust, such as enums, tuples, and tuple structs. These types will generate an error when serialized.
Currently a serializer always writes its output to an in-memory String
,
which is passed in when creating the serializer itself.
To serialize TOML values, instead of documents, see ValueSerializer
.
Implementations§
§impl<'d> Serializer<'d>
impl<'d> Serializer<'d>
pub fn new(dst: &'d mut String) -> Serializer<'d>
pub fn new(dst: &'d mut String) -> Serializer<'d>
Creates a new serializer which will emit TOML into the buffer provided.
The serializer can then be used to serialize a type after which the data
will be present in dst
.
pub fn pretty(dst: &'d mut String) -> Serializer<'d>
pub fn pretty(dst: &'d mut String) -> Serializer<'d>
Apply a default “pretty” policy to the document
For greater customization, instead serialize to a
toml_edit::Document
.
Trait Implementations§
§impl<'d> Serializer for Serializer<'d>
impl<'d> Serializer for Serializer<'d>
§type Ok = ()
type Ok = ()
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.§type SerializeSeq = SerializeDocumentArray<'d>
type SerializeSeq = SerializeDocumentArray<'d>
serialize_seq
for serializing the content of the
sequence.§type SerializeTuple = SerializeDocumentArray<'d>
type SerializeTuple = SerializeDocumentArray<'d>
serialize_tuple
for serializing the content of
the tuple.§type SerializeTupleStruct = SerializeDocumentArray<'d>
type SerializeTupleStruct = SerializeDocumentArray<'d>
serialize_tuple_struct
for serializing the
content of the tuple struct.§type SerializeTupleVariant = SerializeDocumentArray<'d>
type SerializeTupleVariant = SerializeDocumentArray<'d>
serialize_tuple_variant
for serializing the
content of the tuple variant.§type SerializeMap = SerializeDocumentTable<'d>
type SerializeMap = SerializeDocumentTable<'d>
serialize_map
for serializing the content of the
map.§type SerializeStruct = SerializeDocumentTable<'d>
type SerializeStruct = SerializeDocumentTable<'d>
serialize_struct
for serializing the content of
the struct.§type SerializeStructVariant = Impossible<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
type SerializeStructVariant = Impossible<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
serialize_struct_variant
for serializing the
content of the struct variant.§fn serialize_bool(
self,
v: bool
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_bool( self, v: bool ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
bool
value. Read more§fn serialize_i8(
self,
v: i8
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_i8( self, v: i8 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
i8
value. Read more§fn serialize_i16(
self,
v: i16
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_i16( self, v: i16 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
i16
value. Read more§fn serialize_i32(
self,
v: i32
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_i32( self, v: i32 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
i32
value. Read more§fn serialize_i64(
self,
v: i64
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_i64( self, v: i64 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
i64
value. Read more§fn serialize_u8(
self,
v: u8
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_u8( self, v: u8 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
u8
value. Read more§fn serialize_u16(
self,
v: u16
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_u16( self, v: u16 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
u16
value. Read more§fn serialize_u32(
self,
v: u32
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_u32( self, v: u32 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
u32
value. Read more§fn serialize_u64(
self,
v: u64
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_u64( self, v: u64 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
u64
value. Read more§fn serialize_f32(
self,
v: f32
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_f32( self, v: f32 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
f32
value. Read more§fn serialize_f64(
self,
v: f64
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_f64( self, v: f64 ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
f64
value. Read more§fn serialize_char(
self,
v: char
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_char( self, v: char ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
§fn serialize_str(
self,
v: &str
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_str( self, v: &str ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
&str
. Read more§fn serialize_bytes(
self,
v: &[u8]
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_bytes( self, v: &[u8] ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
§fn serialize_none(
self
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_none( self ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
§fn serialize_some<T>(
self,
v: &T
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_some<T>( self, v: &T ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
§fn serialize_unit(
self
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_unit( self ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
()
value. Read more§fn serialize_unit_struct(
self,
name: &'static str
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_unit_struct( self, name: &'static str ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
§fn serialize_unit_variant(
self,
name: &'static str,
variant_index: u32,
variant: &'static str
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_unit_variant( self, name: &'static str, variant_index: u32, variant: &'static str ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
§fn serialize_newtype_struct<T>(
self,
name: &'static str,
v: &T
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_newtype_struct<T>( self, name: &'static str, v: &T ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
struct Millimeters(u8)
. Read more§fn serialize_newtype_variant<T>(
self,
name: &'static str,
variant_index: u32,
variant: &'static str,
value: &T
) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
fn serialize_newtype_variant<T>( self, name: &'static str, variant_index: u32, variant: &'static str, value: &T ) -> Result<<Serializer<'d> as Serializer>::Ok, <Serializer<'d> as Serializer>::Error>
§fn serialize_seq(
self,
len: Option<usize>
) -> Result<<Serializer<'d> as Serializer>::SerializeSeq, <Serializer<'d> as Serializer>::Error>
fn serialize_seq( self, len: Option<usize> ) -> Result<<Serializer<'d> as Serializer>::SerializeSeq, <Serializer<'d> as Serializer>::Error>
serialize_element
, then a call to
end
. Read more§fn serialize_tuple(
self,
len: usize
) -> Result<<Serializer<'d> as Serializer>::SerializeTuple, <Serializer<'d> as Serializer>::Error>
fn serialize_tuple( self, len: usize ) -> Result<<Serializer<'d> as Serializer>::SerializeTuple, <Serializer<'d> as Serializer>::Error>
serialize_element
,
then a call to end
. Read more§fn serialize_tuple_struct(
self,
_name: &'static str,
len: usize
) -> Result<<Serializer<'d> as Serializer>::SerializeTupleStruct, <Serializer<'d> as Serializer>::Error>
fn serialize_tuple_struct( self, _name: &'static str, len: usize ) -> Result<<Serializer<'d> as Serializer>::SerializeTupleStruct, <Serializer<'d> as Serializer>::Error>
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§fn serialize_tuple_variant(
self,
_name: &'static str,
_variant_index: u32,
_variant: &'static str,
len: usize
) -> Result<<Serializer<'d> as Serializer>::SerializeTupleVariant, <Serializer<'d> as Serializer>::Error>
fn serialize_tuple_variant( self, _name: &'static str, _variant_index: u32, _variant: &'static str, len: usize ) -> Result<<Serializer<'d> as Serializer>::SerializeTupleVariant, <Serializer<'d> as Serializer>::Error>
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§fn serialize_map(
self,
len: Option<usize>
) -> Result<<Serializer<'d> as Serializer>::SerializeMap, <Serializer<'d> as Serializer>::Error>
fn serialize_map( self, len: Option<usize> ) -> Result<<Serializer<'d> as Serializer>::SerializeMap, <Serializer<'d> as Serializer>::Error>
serialize_key
and serialize_value
, then a call to end
. Read more§fn serialize_struct(
self,
_name: &'static str,
len: usize
) -> Result<<Serializer<'d> as Serializer>::SerializeStruct, <Serializer<'d> as Serializer>::Error>
fn serialize_struct( self, _name: &'static str, len: usize ) -> Result<<Serializer<'d> as Serializer>::SerializeStruct, <Serializer<'d> as Serializer>::Error>
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§fn serialize_struct_variant(
self,
name: &'static str,
_variant_index: u32,
_variant: &'static str,
_len: usize
) -> Result<<Serializer<'d> as Serializer>::SerializeStructVariant, <Serializer<'d> as Serializer>::Error>
fn serialize_struct_variant( self, name: &'static str, _variant_index: u32, _variant: &'static str, _len: usize ) -> Result<<Serializer<'d> as Serializer>::SerializeStructVariant, <Serializer<'d> as Serializer>::Error>
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 moresource§fn serialize_i128(self, v: i128) -> Result<Self::Ok, Self::Error>
fn serialize_i128(self, v: i128) -> Result<Self::Ok, Self::Error>
i128
value. Read moresource§fn serialize_u128(self, v: u128) -> Result<Self::Ok, Self::Error>
fn serialize_u128(self, v: u128) -> Result<Self::Ok, Self::Error>
u128
value. Read moresource§fn collect_seq<I>(self, iter: I) -> Result<Self::Ok, Self::Error>
fn collect_seq<I>(self, iter: I) -> Result<Self::Ok, Self::Error>
source§fn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error>
fn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error>
source§fn collect_str<T>(self, value: &T) -> Result<Self::Ok, Self::Error>
fn collect_str<T>(self, value: &T) -> Result<Self::Ok, Self::Error>
Display
. Read moresource§fn is_human_readable(&self) -> bool
fn is_human_readable(&self) -> bool
Serialize
implementations should serialize in
human-readable form. Read moreAuto Trait Implementations§
impl<'d> RefUnwindSafe for Serializer<'d>
impl<'d> Send for Serializer<'d>
impl<'d> Sync for Serializer<'d>
impl<'d> Unpin for Serializer<'d>
impl<'d> !UnwindSafe for Serializer<'d>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> CompatExt for T
impl<T> CompatExt for T
§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.