From 5537955b1747f8f8c873cf7681ec8a497404e730 Mon Sep 17 00:00:00 2001
From: Corey Farwell <coreyf@rwell.org>
Date: Sun, 12 Mar 2017 16:21:58 -0400
Subject: Add doc example for `OsString::reserve_exact`.

---
 src/libstd/ffi/os_str.rs | 10 ++++++++++
 1 file changed, 10 insertions(+)

(limited to 'src/libstd')

diff --git a/src/libstd/ffi/os_str.rs b/src/libstd/ffi/os_str.rs
index bdd8ce5e6d8..d960d76146f 100644
--- a/src/libstd/ffi/os_str.rs
+++ b/src/libstd/ffi/os_str.rs
@@ -210,6 +210,16 @@ impl OsString {
     /// Note that the allocator may give the collection more space than it
     /// requests. Therefore capacity can not be relied upon to be precisely
     /// minimal. Prefer reserve if future insertions are expected.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use std::ffi::OsString;
+    ///
+    /// let mut s = OsString::new();
+    /// s.reserve_exact(10);
+    /// assert!(s.capacity() >= 10);
+    /// ```
     #[stable(feature = "osstring_simple_functions", since = "1.9.0")]
     pub fn reserve_exact(&mut self, additional: usize) {
         self.inner.reserve_exact(additional)
-- 
cgit 1.4.1-3-g733a5