[][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()
    }
}

Implementations on Foreign Types

impl Serialize for bool[src][]

impl Serialize for isize[src][]

impl Serialize for i8[src][]

impl Serialize for i16[src][]

impl Serialize for i32[src][]

impl Serialize for i64[src][]

impl Serialize for usize[src][]

impl Serialize for u8[src][]

impl Serialize for u16[src][]

impl Serialize for u32[src][]

impl Serialize for u64[src][]

impl Serialize for f32[src][]

impl Serialize for f64[src][]

impl Serialize for char[src][]

impl Serialize for i128[src][]

impl Serialize for u128[src][]

impl Serialize for str[src][]

impl Serialize for String[src][]

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

impl Serialize for CStr[src][]

impl Serialize for CString[src][]

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

impl<T: ?Sized> Serialize for PhantomData<T>[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<T> Serialize for BinaryHeap<T> where
    T: Serialize + Ord
[src][]

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

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

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

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

impl<T> Serialize for VecDeque<T> where
    T: Serialize
[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 ()[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][]

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

impl<K, V, H> Serialize for HashMap<K, V, H> where
    K: Serialize + Eq + Hash,
    V: Serialize,
    H: BuildHasher
[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: ?Sized> Serialize for Box<T> where
    T: Serialize
[src][]

impl<'a, T: ?Sized> Serialize for Cow<'a, T> where
    T: Serialize + ToOwned
[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 NonZeroI8[src][]

impl Serialize for NonZeroI16[src][]

impl Serialize for NonZeroI32[src][]

impl Serialize for NonZeroI64[src][]

impl Serialize for NonZeroIsize[src][]

impl Serialize for NonZeroU128[src][]

impl Serialize for NonZeroI128[src][]

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

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

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

impl<T> Serialize for RwLock<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 Serialize for SystemTime[src][]

impl Serialize for IpAddr[src][]

impl Serialize for Ipv4Addr[src][]

impl Serialize for Ipv6Addr[src][]

impl Serialize for SocketAddr[src][]

impl Serialize for SocketAddrV4[src][]

impl Serialize for SocketAddrV6[src][]

impl Serialize for Path[src][]

impl Serialize for PathBuf[src][]

impl Serialize for OsStr[src][]

impl Serialize for OsString[src][]

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

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

impl Serialize for AtomicBool[src][]

impl Serialize for AtomicI8[src][]

impl Serialize for AtomicI16[src][]

impl Serialize for AtomicI32[src][]

impl Serialize for AtomicIsize[src][]

impl Serialize for AtomicU8[src][]

impl Serialize for AtomicU16[src][]

impl Serialize for AtomicU32[src][]

impl Serialize for AtomicUsize[src][]

impl Serialize for AtomicI64[src][]

impl Serialize for AtomicU64[src][]

Implementors

impl Serialize for NaiveDate

impl Serialize for NaiveDateTime

impl Serialize for NaiveTime

impl<Tz: TimeZone> Serialize for DateTime<Tz>

impl Serialize for Weekday

impl Serialize for Month

impl Serialize for MacAddress

impl Serialize for IpNet

impl Serialize for Ipv4Net

impl Serialize for Ipv6Net

impl Serialize for ContainerRef

impl Serialize for FlavorRef

impl Serialize for ImageRef

impl Serialize for KeyPairRef

impl Serialize for NetworkRef

impl Serialize for ObjectRef

impl Serialize for ProjectRef

impl Serialize for PortRef

impl Serialize for RouterRef

impl Serialize for SecurityGroupRef

impl Serialize for SnapshotRef

impl Serialize for SubnetRef

impl Serialize for UserRef

impl Serialize for VolumeRef

impl Serialize for BlockDeviceDestinationType

impl Serialize for BlockDevice

impl Serialize for ServerSortKey

impl Serialize for ServerStatus

impl Serialize for ServerPowerState

impl Serialize for RebootType

impl Serialize for AddressType

impl Serialize for KeyPairType

impl Serialize for ImageStatus

impl Serialize for ImageVisibility

impl Serialize for ImageContainerFormat

impl Serialize for ImageDiskFormat

impl Serialize for ImageSortKey

impl Serialize for IpVersion

impl Serialize for NetworkProtocol

impl Serialize for NetworkStatus

impl Serialize for NetworkSortKey

impl Serialize for FloatingIpStatus

impl Serialize for FloatingIpSortKey

impl Serialize for PortSortKey

impl Serialize for RouterSortKey

impl Serialize for RouterStatus

impl Serialize for SubnetSortKey

impl Serialize for Ipv6Mode

impl Serialize for PortExtraDhcpOption

impl Serialize for AllowedAddressPair

impl Serialize for Helper

impl Serialize for ExternalGateway

impl Serialize for AllocationPool

impl Serialize for HostRoute

impl Serialize for ApiVersion

impl<T> Serialize for XdotY<T> where
    T: Display, 

impl Serialize for IdOrName

impl Serialize for UserAndPassword

impl Serialize for Project

impl Serialize for Scope

impl Serialize for Auth

impl Serialize for AuthRoot

impl Serialize for Identity

impl Serialize for Map<String, Value>

impl Serialize for Value

impl Serialize for Number

impl Serialize for Mapping

impl Serialize for Number

impl Serialize for Value

impl<S> Serialize for Host<S> where
    S: Serialize, 

impl Serialize for Url