mikros/serde
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Hyperlink the ser module documentation

Browse Source
This commit is contained in:
David Tolnay 2017-04-13 13:15:23 -07:00
parent c5854f19f7
commit f8e53e837d
No known key found for this signature in database
GPG Key ID: F9BA143B95FF6D82
1 changed files with 35 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
serde/src/ser/mod.rs
View File

@ -1,7 +1,7 @@
//! Generic data structure serialization framework. //! Generic data structure serialization framework.
//! //!
//! The two most important traits in this module are `Serialize` and //! The two most important traits in this module are [`Serialize`] and
//! `Serializer`. //! [`Serializer`].
//! //!
//! - **A type that implements `Serialize` is a data structure** that can be //! - **A type that implements `Serialize` is a data structure** that can be
//! serialized to any data format supported by Serde, and conversely //! serialized to any data format supported by Serde, and conversely
@ -10,39 +10,38 @@
//! //!
//! # The Serialize trait //! # The Serialize trait
//! //!
//! Serde provides `Serialize` implementations for many Rust primitive and //! Serde provides [`Serialize`] implementations for many Rust primitive and
//! standard library types. The complete list is below. All of these can be //! standard library types. The complete list is below. All of these can be
//! serialized using Serde out of the box. //! serialized using Serde out of the box.
//! //!
//! Additionally, Serde provides a procedural macro called `serde_derive` to //! Additionally, Serde provides a procedural macro called [`serde_derive`] to
//! automatically generate `Serialize` implementations for structs and enums in //! automatically generate [`Serialize`] implementations for structs and enums
//! your program. See the [codegen section of the manual][codegen] for how to //! in your program. See the [codegen section of the manual] for how to use
//! use this. //! this.
//! //!
//! In rare cases it may be necessary to implement `Serialize` manually for some //! In rare cases it may be necessary to implement [`Serialize`] manually for
//! type in your program. See the [Implementing `Serialize`][impl-serialize] //! some type in your program. See the [Implementing `Serialize`] section of the
//! section of the manual for more about this. //! manual for more about this.
//! //!
//! Third-party crates may provide `Serialize` implementations for types that //! Third-party crates may provide [`Serialize`] implementations for types that
//! they expose. For example the `linked-hash-map` crate provides a //! they expose. For example the [`linked-hash-map`] crate provides a
//! `LinkedHashMap<K, V>` type that is serializable by Serde because the crate //! [`LinkedHashMap<K, V>`] type that is serializable by Serde because the crate
//! provides an implementation of `Serialize` for it. //! provides an implementation of [`Serialize`] for it.
//! //!
//! # The Serializer trait //! # The Serializer trait
//! //!
//! `Serializer` implementations are provided by third-party crates, for example //! [`Serializer`] implementations are provided by third-party crates, for
//! [`serde_json`][serde_json], [`serde_yaml`][serde_yaml] and //! example [`serde_json`], [`serde_yaml`] and [`bincode`].
//! [`bincode`][bincode].
//! //!
//! A partial list of well-maintained formats is given on the [Serde //! A partial list of well-maintained formats is given on the [Serde
//! website][data-formats]. //! website][data formats].
//! //!
//! # Implementations of Serialize provided by Serde //! # Implementations of Serialize provided by Serde
//! //!
//! - **Primitive types**: //! - **Primitive types**:
//! - bool //! - bool
//! - isize, i8, i16, i32, i64 //! - i8, i16, i32, i64, isize
//! - usize, u8, u16, u32, u64 //! - u8, u16, u32, u64, usize
//! - f32, f64 //! - f32, f64
//! - char //! - char
//! - str //! - str
@ -71,6 +70,11 @@
//! - VecDeque\<T\> //! - VecDeque\<T\>
//! - Vec\<T\> //! - Vec\<T\>
//! - EnumSet\<T\> (unstable) //! - EnumSet\<T\> (unstable)
//! - **FFI types**:
//! - CStr
//! - CString
//! - OsStr
//! - OsString
//! - **Miscellaneous standard library types**: //! - **Miscellaneous standard library types**:
//! - Duration //! - Duration
//! - Path //! - Path
@ -85,12 +89,17 @@
//! - SocketAddrV4 //! - SocketAddrV4
//! - SocketAddrV6 //! - SocketAddrV6
//! //!
//! [codegen]: https://serde.rs/codegen.html //! [Implementing `Serialize`]: https://serde.rs/impl-serialize.html
//! [impl-serialize]: https://serde.rs/impl-serialize.html //! [`LinkedHashMap<K, V>`]: https://docs.rs/linked-hash-map/*/linked_hash_map/struct.LinkedHashMap.html
//! [serde_json]: https://github.com/serde-rs/json //! [`Serialize`]: ../trait.Serialize.html
//! [serde_yaml]: https://github.com/dtolnay/serde-yaml //! [`Serializer`]: ../trait.Serializer.html
//! [bincode]: https://github.com/TyOverby/bincode //! [`bincode`]: https://github.com/TyOverby/bincode
//! [data-formats]: https://serde.rs/#data-formats //! [`linked-hash-map`]: https://crates.io/crates/linked-hash-map
//! [`serde_derive`]: https://crates.io/crates/serde_derive
//! [`serde_json`]: https://github.com/serde-rs/json
//! [`serde_yaml`]: https://github.com/dtolnay/serde-yaml
//! [codegen section of the manual]: https://serde.rs/codegen.html
//! [data formats]: https://serde.rs/#data-formats
use lib::*; use lib::*;