[−][src]Trait serde::ser::Serialize

pub trait Serialize {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer;
}

A data structure that can be serialized into any data format supported by Serde.

Serde provides Serialize implementations for many Rust primitive and standard library types. The complete list is here. All of these can be serialized using Serde out of the box.

Additionally, Serde provides a procedural macro called serde_derive to automatically generate Serialize implementations for structs and enums in your program. See the derive section of the manual for how to use this.

In rare cases it may be necessary to implement Serialize manually for some type in your program. See the Implementing Serialize section of the manual for more about this.

Third-party crates may provide Serialize implementations for types that they expose. For example the linked-hash-map crate provides a LinkedHashMap<K, V> type that is serializable by Serde because the crate provides an implementation of Serialize for it.

Required methods

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.

See the Implementing Serialize section of the manual for more information about how to implement this method.

ⓘThis code runs with edition 2018
use serde::ser::{Serialize, SerializeStruct, Serializer};

struct Person {
    name: String,
    age: u8,
    phones: Vec<String>,
}

// This is what #[derive(Serialize)] would generate.
impl Serialize for Person {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        let mut s = serializer.serialize_struct("Person", 3)?;
        s.serialize_field("name", &self.name)?;
        s.serialize_field("age", &self.age)?;
        s.serialize_field("phones", &self.phones)?;
        s.end()
    }
}
Loading content...

Implementations on Foreign Types

impl<'a> Serialize for Arguments<'a>[src]

impl<T> Serialize for Option<T> where
    T: Serialize, [src]

impl<T: ?Sized> Serialize for PhantomData<T>[src]

impl<Idx> Serialize for Range<Idx> where
    Idx: Serialize, [src]

impl<Idx> Serialize for RangeInclusive<Idx> where
    Idx: Serialize, [src]

impl<T> Serialize for Bound<T> where
    T: Serialize, [src]

impl Serialize for NonZeroU8[src]

impl Serialize for NonZeroU16[src]

impl Serialize for NonZeroU32[src]

impl Serialize for NonZeroU64[src]

impl Serialize for NonZeroUsize[src]

impl Serialize for NonZeroU128[src]

impl<T> Serialize for Cell<T> where
    T: Serialize + Copy, [src]

impl<T> Serialize for RefCell<T> where
    T: Serialize, [src]

impl<T, E> Serialize for Result<T, E> where
    T: Serialize,
    E: Serialize, [src]

impl Serialize for Duration[src]

impl<T> Serialize for Reverse<T> where
    T: Serialize, [src]

Loading content...

Implementors

impl Serialize for ()[src]

impl Serialize for bool[src]

impl Serialize for char[src]

impl Serialize for f32[src]

impl Serialize for f64[src]

impl Serialize for i8[src]

impl Serialize for i16[src]

impl Serialize for i32[src]

impl Serialize for i64[src]

impl Serialize for i128[src]

impl Serialize for isize[src]

impl Serialize for str[src]

impl Serialize for u8[src]

impl Serialize for u16[src]

impl Serialize for u32[src]

impl Serialize for u64[src]

impl Serialize for u128[src]

impl Serialize for usize[src]

impl<'a, T: ?Sized> Serialize for &'a T where
    T: Serialize, [src]

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

impl<T> Serialize for [T; 0][src]

impl<T> Serialize for [T; 1] where
    T: Serialize, [src]

impl<T> Serialize for [T; 2] where
    T: Serialize, [src]

impl<T> Serialize for [T; 3] where
    T: Serialize, [src]

impl<T> Serialize for [T; 4] where
    T: Serialize, [src]

impl<T> Serialize for [T; 5] where
    T: Serialize, [src]

impl<T> Serialize for [T; 6] where
    T: Serialize, [src]

impl<T> Serialize for [T; 7] where
    T: Serialize, [src]

impl<T> Serialize for [T; 8] where
    T: Serialize, [src]

impl<T> Serialize for [T; 9] where
    T: Serialize, [src]

impl<T> Serialize for [T; 10] where
    T: Serialize, [src]

impl<T> Serialize for [T; 11] where
    T: Serialize, [src]

impl<T> Serialize for [T; 12] where
    T: Serialize, [src]

impl<T> Serialize for [T; 13] where
    T: Serialize, [src]

impl<T> Serialize for [T; 14] where
    T: Serialize, [src]

impl<T> Serialize for [T; 15] where
    T: Serialize, [src]

impl<T> Serialize for [T; 16] where
    T: Serialize, [src]

impl<T> Serialize for [T; 17] where
    T: Serialize, [src]

impl<T> Serialize for [T; 18] where
    T: Serialize, [src]

impl<T> Serialize for [T; 19] where
    T: Serialize, [src]

impl<T> Serialize for [T; 20] where
    T: Serialize, [src]

impl<T> Serialize for [T; 21] where
    T: Serialize, [src]

impl<T> Serialize for [T; 22] where
    T: Serialize, [src]

impl<T> Serialize for [T; 23] where
    T: Serialize, [src]

impl<T> Serialize for [T; 24] where
    T: Serialize, [src]

impl<T> Serialize for [T; 25] where
    T: Serialize, [src]

impl<T> Serialize for [T; 26] where
    T: Serialize, [src]

impl<T> Serialize for [T; 27] where
    T: Serialize, [src]

impl<T> Serialize for [T; 28] where
    T: Serialize, [src]

impl<T> Serialize for [T; 29] where
    T: Serialize, [src]

impl<T> Serialize for [T; 30] where
    T: Serialize, [src]

impl<T> Serialize for [T; 31] where
    T: Serialize, [src]

impl<T> Serialize for [T; 32] where
    T: Serialize, [src]

impl<T> Serialize for [T] where
    T: Serialize, [src]

impl<T0> Serialize for (T0,) where
    T0: Serialize, [src]

impl<T0, T1> Serialize for (T0, T1) where
    T0: Serialize,
    T1: Serialize, [src]

impl<T0, T1, T2> Serialize for (T0, T1, T2) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize, [src]

impl<T0, T1, T2, T3> Serialize for (T0, T1, T2, T3) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize, [src]

impl<T0, T1, T2, T3, T4> Serialize for (T0, T1, T2, T3, T4) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5> Serialize for (T0, T1, T2, T3, T4, T5) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6> Serialize for (T0, T1, T2, T3, T4, T5, T6) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6, T7> Serialize for (T0, T1, T2, T3, T4, T5, T6, T7) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8> Serialize for (T0, T1, T2, T3, T4, T5, T6, T7, T8) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9> Serialize for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10> Serialize for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize,
    T10: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11> Serialize for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize,
    T10: Serialize,
    T11: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12> Serialize for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize,
    T10: Serialize,
    T11: Serialize,
    T12: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13> Serialize for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize,
    T10: Serialize,
    T11: Serialize,
    T12: Serialize,
    T13: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14> Serialize for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize,
    T10: Serialize,
    T11: Serialize,
    T12: Serialize,
    T13: Serialize,
    T14: Serialize, [src]

impl<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15> Serialize for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize,
    T10: Serialize,
    T11: Serialize,
    T12: Serialize,
    T13: Serialize,
    T14: Serialize,
    T15: Serialize, [src]

Loading content...