Add doc example for `CStr::to_bytes`.

diff --git a/src/libstd/ffi/c_str.rs b/src/libstd/ffi/c_str.rs
index 74ac9d528bb626102eae7ae708b8885db43f85f5..ecad407f261ed127d767013da337e92867f8c4f7 100644 (file)
--- a/src/libstd/ffi/c_str.rs
+++ b/src/libstd/ffi/c_str.rs
@@ -800,6 +800,15 @@ pub fn as_ptr(&self) -> *const c_char {
     /// > **Note**: This method is currently implemented as a 0-cost cast, but
     /// > it is planned to alter its definition in the future to perform the
     /// > length calculation whenever this method is called.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use std::ffi::CStr;
+    ///
+    /// let c_str = CStr::from_bytes_with_nul(b"foo\0").unwrap();
+    /// assert_eq!(c_str.to_bytes(), b"foo");
+    /// ```
     #[inline]
     #[stable(feature = "rust1", since = "1.0.0")]
     pub fn to_bytes(&self) -> &[u8] {