[][src]Trait surf::http::convert::Serialize

pub trait Serialize {
    fn serialize<S>(
        &self,
        serializer: S
    ) -> Result<<S as Serializer>::Ok, <S as Serializer>::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 as Serializer>::Ok, <S as Serializer>::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 Serialize for AtomicI64[src]

impl<T> Serialize for BTreeSet<T> where
    T: Serialize + Ord
[src]

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

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

impl Serialize for str[src]

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

impl<T> Serialize for [T; 5] where
    T: 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,
    T10: Serialize,
    T11: Serialize,
    T12: Serialize,
    T13: 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, 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,
    T10: Serialize,
    T11: Serialize,
    T12: Serialize,
    T13: Serialize,
    T14: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize
[src]

impl Serialize for String[src]

impl Serialize for u16[src]

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

impl<T, H> Serialize for HashSet<T, H> where
    H: BuildHasher,
    T: Serialize + Eq + Hash
[src]

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

impl Serialize for IpAddr[src]

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

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

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

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

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

impl Serialize for NonZeroU128[src]

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

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

impl Serialize for NonZeroU64[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,
    T10: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize
[src]

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

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

impl Serialize for u128[src]

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

impl<K, V> Serialize for BTreeMap<K, V> where
    K: Serialize + Ord,
    V: Serialize
[src]

impl Serialize for i128[src]

impl Serialize for i32[src]

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

impl Serialize for AtomicIsize[src]

impl Serialize for NonZeroU32[src]

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

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

impl Serialize for isize[src]

impl<T> Serialize for [T; 27] where
    T: 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 Serialize for AtomicU32[src]

impl Serialize for NonZeroUsize[src]

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

impl Serialize for AtomicBool[src]

impl<T> Serialize for [T; 6] where
    T: 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 Serialize for NonZeroI128[src]

impl Serialize for u8[src]

impl Serialize for NonZeroU16[src]

impl Serialize for NonZeroI8[src]

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

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

impl Serialize for NonZeroIsize[src]

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

impl Serialize for Duration[src]

impl Serialize for f32[src]

impl Serialize for AtomicU8[src]

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

impl Serialize for NonZeroI32[src]

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

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

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

impl Serialize for char[src]

impl Serialize for Path[src]

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

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

impl<K, V, H> Serialize for HashMap<K, V, H> where
    H: BuildHasher,
    K: Serialize + Eq + Hash,
    V: Serialize
[src]

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

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

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

impl Serialize for AtomicI16[src]

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

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

impl Serialize for CString[src]

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

impl Serialize for NonZeroU8[src]

impl Serialize for i64[src]

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

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

impl<T> Serialize for [T; 17] where
    T: 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 Serialize for SocketAddrV4[src]

impl<T> Serialize for [T; 29] where
    T: 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,
    T10: Serialize,
    T11: 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, 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,
    T10: Serialize,
    T11: Serialize,
    T12: Serialize,
    T13: Serialize,
    T14: Serialize,
    T15: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize,
    T6: Serialize,
    T7: Serialize,
    T8: Serialize,
    T9: Serialize
[src]

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

impl Serialize for NonZeroI16[src]

impl Serialize for SocketAddr[src]

impl Serialize for i8[src]

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

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

impl Serialize for u32[src]

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

impl Serialize for OsStr[src]

impl Serialize for Ipv6Addr[src]

impl Serialize for NonZeroI64[src]

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

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

impl Serialize for AtomicU16[src]

impl Serialize for AtomicUsize[src]

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

impl Serialize for OsString[src]

impl<T> Serialize for Box<T> where
    T: Serialize + ?Sized
[src]

impl Serialize for i16[src]

impl Serialize for usize[src]

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

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

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

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

impl<T> Serialize for BinaryHeap<T> where
    T: Serialize + Ord
[src]

impl Serialize for SystemTime[src]

impl Serialize for bool[src]

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

impl Serialize for PathBuf[src]

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

impl Serialize for AtomicU64[src]

impl Serialize for SocketAddrV6[src]

impl Serialize for f64[src]

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

impl Serialize for AtomicI32[src]

impl Serialize for Ipv4Addr[src]

impl Serialize for ()[src]

impl Serialize for u64[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, 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,
    T10: Serialize,
    T11: Serialize,
    T12: 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> Serialize for (T0, T1, T2, T3, T4, T5) where
    T0: Serialize,
    T1: Serialize,
    T2: Serialize,
    T3: Serialize,
    T4: Serialize,
    T5: Serialize
[src]

impl Serialize for AtomicI8[src]

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

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

impl Serialize for CStr[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 Serialize for Value[src]

impl Serialize for Map<String, Value>[src]

impl Serialize for Number[src]

Loading content...

Implementors

impl Serialize for ReportTo[src]

impl Serialize for ReportToEndpoint[src]

impl Serialize for Url[src]

Serializes this URL into a serde stream.

This implementation is only available if the serde Cargo feature is enabled.

impl<S> Serialize for Host<S> where
    S: Serialize
[src]

Loading content...