Add generic serialize `to_writer` method.

2 files changed, 37 insertions, 1 deletions

diff --git a/src/lib.rs b/src/lib.rs
index e5ee7e2..d55f0b4 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -138,4 +138,4 @@ pub use de::{from_bytes, from_str};
 pub use de::Config;
 pub use error::Error;
 #[doc(inline)]
-pub use ser::{QsSerializer, to_string};
+pub use ser::{QsSerializer, to_string, to_writer};
diff --git a/src/ser.rs b/src/ser.rs
index a78d6be..4206e60 100644
--- a/src/ser.rs
+++ b/src/ser.rs
@@ -63,6 +63,42 @@ pub fn to_string<T: ser::Serialize>(input: &T) -> Result<String> {
     String::from_utf8(buffer).map_err(Error::from)
 }
 
+/// Serializes a value into a generic writer object.
+///
+/// ```
+/// # #[macro_use]
+/// # extern crate serde_derive;
+/// # extern crate serde_qs;
+/// #[derive(Deserialize, Serialize)]
+/// struct Query {
+///     name: String,
+///     age: u8,
+///     occupation: String,
+/// }
+///
+/// # fn main(){
+/// let q =  Query {
+///     name: "Alice".to_owned(),
+///     age: 24,
+///     occupation: "Student".to_owned(),
+/// };
+///
+/// let mut buffer = Vec::new();
+/// serde_qs::to_writer(&q, &mut buffer).unwrap();
+/// assert_eq!(
+///     String::from_utf8(buffer).unwrap(),
+///     "name=Alice&age=24&occupation=Student");
+/// # }
+/// ```
+pub fn to_writer<T: ser::Serialize, W: Write>(input: &T, writer: &mut W) -> Result<()> {
+    let mut first = true;
+    input.serialize(&mut QsSerializer {
+            writer: writer,
+            key: None,
+            first: &mut first,
+        })
+}
+
 /// A serializer for the querystring format.
 ///
 /// * Supported top-level inputs are structs and maps.