From 833a9b567ae15d691455457a476480d422e6f7a7 Mon Sep 17 00:00:00 2001
From: 42triangles <dodo2998@gmail.com>
Date: Mon, 11 Sep 2017 08:13:57 +0200
Subject: [PATCH] Added an example for `std::str::into_boxed_bytes()`

---
 src/liballoc/str.rs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/liballoc/str.rs b/src/liballoc/str.rs
index f0c63a2eb55..c48ff3f5cc3 100644
--- a/src/liballoc/str.rs
+++ b/src/liballoc/str.rs
@@ -1783,6 +1783,17 @@ pub fn parse<F: FromStr>(&self) -> Result<F, F::Err> {
     }
 
     /// Converts a `Box<str>` into a `Box<[u8]>` without copying or allocating.
+    /// 
+    /// # Examples
+    ///
+    /// Basic usage:
+    ///
+    /// ```
+    /// let s = "this is a string";
+    /// let boxed_str = s.to_owned().into_boxed_str();
+    /// let boxed_bytes = boxed_str.into_boxed_bytes();
+    /// assert_eq!(*boxed_bytes, *s.as_bytes());
+    /// ```
     #[stable(feature = "str_box_extras", since = "1.20.0")]
     pub fn into_boxed_bytes(self: Box<str>) -> Box<[u8]> {
         self.into()