From 07bce54ad34392cac80b37d673e3e96be80d689d Mon Sep 17 00:00:00 2001
From: David Tolnay <dtolnay@gmail.com>
Date: Thu, 13 Apr 2017 14:21:28 -0700
Subject: [PATCH] Add a collect_map example

---
 serde/src/ser/mod.rs | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/serde/src/ser/mod.rs b/serde/src/ser/mod.rs
index d6ee65ae..189cf766 100644
--- a/serde/src/ser/mod.rs
+++ b/serde/src/ser/mod.rs
@@ -917,6 +917,24 @@ pub trait Serializer: Sized {
     /// using [`serialize_map`]. Implementors should not need to override this
     /// method.
     ///
+    /// ```rust
+    /// use std::collections::BTreeSet;
+    /// use serde::{Serialize, Serializer};
+    ///
+    /// struct MapToUnit {
+    ///     keys: BTreeSet<i32>,
+    /// }
+    ///
+    /// // Serializes as a map in which the values are all unit.
+    /// impl Serialize for MapToUnit {
+    ///     fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    ///         where S: Serializer
+    ///     {
+    ///         serializer.collect_map(self.keys.iter().map(|k| (k, ())))
+    ///     }
+    /// }
+    /// ```
+    ///
     /// [`serialize_map`]: #tymethod.serialize_map
     fn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error>
     where