Add doc example for `std::io::sink`.

1 files changed, 10 insertions, 0 deletions

diff --git a/src/libstd/io/util.rs b/src/libstd/io/util.rs
index 2815c0163d6..e5d6cb2b34e 100644
--- a/src/libstd/io/util.rs
+++ b/src/libstd/io/util.rs
@@ -139,6 +139,16 @@ pub struct Sink { _priv: () }
 ///
 /// All calls to `write` on the returned instance will return `Ok(buf.len())`
 /// and the contents of the buffer will not be inspected.
+///
+/// # Examples
+///
+/// ```rust
+/// use std::io::{self, Write};
+///
+/// let mut buffer = vec![1, 2, 3, 5, 8];
+/// let num_bytes = io::sink().write(&mut buffer).unwrap();
+/// assert_eq!(num_bytes, 5);
+/// ```
 #[stable(feature = "rust1", since = "1.0.0")]
 pub fn sink() -> Sink { Sink { _priv: () } }