From ee952db1a2202f054e37ce54f62856168f622975 Mon Sep 17 00:00:00 2001
From: Kris Hall <echelon@localhost.localdomain>
Date: Thu, 19 Nov 2020 15:26:08 -0600
Subject: [PATCH] Added samples for String.replace() function

---
 libraries/stdlib/common/src/kotlin/TextH.kt           | 4 ++++
 libraries/stdlib/samples/test/samples/text/strings.kt | 9 +++++++++
 2 files changed, 13 insertions(+)

diff --git a/libraries/stdlib/common/src/kotlin/TextH.kt b/libraries/stdlib/common/src/kotlin/TextH.kt
index 10e88020a10..e750cd88edb 100644
--- a/libraries/stdlib/common/src/kotlin/TextH.kt
+++ b/libraries/stdlib/common/src/kotlin/TextH.kt
@@ -196,12 +196,16 @@ public expect fun CharSequence.repeat(n: Int): String
 
 /**
  * Returns a new string with all occurrences of [oldChar] replaced with [newChar].
+ * 
+ * @sample samples.text.Strings.replace
  */
 expect fun String.replace(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String
 
 /**
  * Returns a new string obtained by replacing all occurrences of the [oldValue] substring in this string
  * with the specified [newValue] string.
+ *
+ * @sample samples.text.Strings.replace
  */
 expect fun String.replace(oldValue: String, newValue: String, ignoreCase: Boolean = false): String
 
diff --git a/libraries/stdlib/samples/test/samples/text/strings.kt b/libraries/stdlib/samples/test/samples/text/strings.kt
index 6faa1ef3826..70379dfc58e 100644
--- a/libraries/stdlib/samples/test/samples/text/strings.kt
+++ b/libraries/stdlib/samples/test/samples/text/strings.kt
@@ -445,4 +445,13 @@ class Strings {
         assertPrints(emptyString.lastOrNull(), "null")
         assertFails { emptyString.last() }
     }
+
+    @Sample
+    fun replace() {
+        val inputString0 = "Mississippi"
+        val inputString1 = "Insufficient data for meaningful answer."
+
+        assertPrints(inputString0.replace('s', 'z'), "Mizzizzippi")
+        assertPrints(inputString1.replace("data", "information"), "Insufficient information for meaningful answer.")
+    }
 }