From b8e0989445b3e29affa529d8f1b8574267fda495 Mon Sep 17 00:00:00 2001
From: rwakulszowa <rwakulszowa1@gmail.com>
Date: Tue, 12 Sep 2017 11:53:16 +0100
Subject: [PATCH] Add an example of std::str::encode_utf16

Closes #44419
---
 src/liballoc/str.rs | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/liballoc/str.rs b/src/liballoc/str.rs
index f0c63a2eb55..a665480bba7 100644
--- a/src/liballoc/str.rs
+++ b/src/liballoc/str.rs
@@ -855,6 +855,19 @@ impl str {
     }
 
     /// Returns an iterator of `u16` over the string encoded as UTF-16.
+    ///
+    /// # Examples
+    ///
+    /// Basic usage:
+    ///
+    /// ```
+    /// let text = "Zażółć gęślą jaźń";
+    ///
+    /// let utf8_len = text.len();
+    /// let utf16_len = text.encode_utf16().count();
+    ///
+    /// assert!(utf16_len <= utf8_len);
+    /// ```
     #[stable(feature = "encode_utf16", since = "1.8.0")]
     pub fn encode_utf16(&self) -> EncodeUtf16 {
         EncodeUtf16 { encoder: Utf16Encoder::new(self[..].chars()) }