From d9df2963ad40b67aecde95cbfe98599a45351352 Mon Sep 17 00:00:00 2001
From: Corey Farwell <coreyf@rwell.org>
Date: Tue, 1 Aug 2017 08:12:01 -0400
Subject: [PATCH] Add doc example for HashSet::drain.

---
 src/libstd/collections/hash/set.rs | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/src/libstd/collections/hash/set.rs b/src/libstd/collections/hash/set.rs
index 3c39db3fbabb..80a223c7d74e 100644
--- a/src/libstd/collections/hash/set.rs
+++ b/src/libstd/collections/hash/set.rs
@@ -453,6 +453,22 @@ impl<T, S> HashSet<T, S>
     }
 
     /// Clears the set, returning all elements in an iterator.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use std::collections::HashSet;
+    ///
+    /// let mut set: HashSet<_> = [1, 2, 3].iter().cloned().collect();
+    /// assert!(!set.is_empty());
+    ///
+    /// // print 1, 2, 3 in an arbitrary order
+    /// for i in set.drain() {
+    ///     println!("{}", i);
+    /// }
+    ///
+    /// assert!(set.is_empty());
+    /// ```
     #[inline]
     #[stable(feature = "drain", since = "1.6.0")]
     pub fn drain(&mut self) -> Drain<T> {