From d7b10f31b4b52aea9ff98695ed7acf5372e58669 Mon Sep 17 00:00:00 2001
From: Abduqodiri Qurbonzoda <abduqodiri.qurbonzoda@jetbrains.com>
Date: Fri, 23 Jul 2021 13:29:04 +0300
Subject: [PATCH] Add Regex splitToSequence samples

---
 .../runtime/src/main/kotlin/kotlin/text/Regex.kt     |  1 +
 libraries/stdlib/common/src/kotlin/TextH.kt          |  1 +
 libraries/stdlib/js/src/kotlin/text/regex.kt         |  1 +
 libraries/stdlib/jvm/src/kotlin/text/regex/Regex.kt  |  1 +
 libraries/stdlib/samples/test/samples/text/regex.kt  | 12 ++++++++++++
 .../stdlib/samples/test/samples/text/strings.kt      | 12 ++++++++++++
 libraries/stdlib/src/kotlin/text/Strings.kt          |  1 +
 libraries/stdlib/wasm/src/kotlin/Text.kt             |  1 +
 8 files changed, 30 insertions(+)

diff --git a/kotlin-native/runtime/src/main/kotlin/kotlin/text/Regex.kt b/kotlin-native/runtime/src/main/kotlin/kotlin/text/Regex.kt
index 0c95bac2554..ca4bea87cc0 100644
--- a/kotlin-native/runtime/src/main/kotlin/kotlin/text/Regex.kt
+++ b/kotlin-native/runtime/src/main/kotlin/kotlin/text/Regex.kt
@@ -339,6 +339,7 @@ public actual class Regex internal constructor(internal val nativePattern: Patte
      *
      * @param limit Non-negative value specifying the maximum number of substrings the string can be split to.
      * Zero by default means no limit is set.
+     * @sample samples.text.Regexps.splitToSequence
      */
     @SinceKotlin("1.5")
     @ExperimentalStdlibApi
diff --git a/libraries/stdlib/common/src/kotlin/TextH.kt b/libraries/stdlib/common/src/kotlin/TextH.kt
index d6f14fb477b..46c9a4709f7 100644
--- a/libraries/stdlib/common/src/kotlin/TextH.kt
+++ b/libraries/stdlib/common/src/kotlin/TextH.kt
@@ -77,6 +77,7 @@ expect class Regex {
      *
      * @param limit Non-negative value specifying the maximum number of substrings the string can be split to.
      * Zero by default means no limit is set.
+     * @sample samples.text.Regexps.splitToSequence
      */
     @SinceKotlin("1.5")
     @ExperimentalStdlibApi
diff --git a/libraries/stdlib/js/src/kotlin/text/regex.kt b/libraries/stdlib/js/src/kotlin/text/regex.kt
index 8b3978b14b3..f70b1fe0f10 100644
--- a/libraries/stdlib/js/src/kotlin/text/regex.kt
+++ b/libraries/stdlib/js/src/kotlin/text/regex.kt
@@ -211,6 +211,7 @@ public actual class Regex actual constructor(pattern: String, options: Set<Regex
      *
      * @param limit Non-negative value specifying the maximum number of substrings the string can be split to.
      * Zero by default means no limit is set.
+     * @sample samples.text.Regexps.splitToSequence
      */
     @SinceKotlin("1.5")
     @ExperimentalStdlibApi
diff --git a/libraries/stdlib/jvm/src/kotlin/text/regex/Regex.kt b/libraries/stdlib/jvm/src/kotlin/text/regex/Regex.kt
index 26cc343296d..fb69a8d589b 100644
--- a/libraries/stdlib/jvm/src/kotlin/text/regex/Regex.kt
+++ b/libraries/stdlib/jvm/src/kotlin/text/regex/Regex.kt
@@ -230,6 +230,7 @@ internal constructor(private val nativePattern: Pattern) : Serializable {
      *
      * @param limit Non-negative value specifying the maximum number of substrings the string can be split to.
      * Zero by default means no limit is set.
+     * @sample samples.text.Regexps.splitToSequence
      */
     @SinceKotlin("1.5")
     @ExperimentalStdlibApi
diff --git a/libraries/stdlib/samples/test/samples/text/regex.kt b/libraries/stdlib/samples/test/samples/text/regex.kt
index 9fd4d5d4957..1479baf0bcd 100644
--- a/libraries/stdlib/samples/test/samples/text/regex.kt
+++ b/libraries/stdlib/samples/test/samples/text/regex.kt
@@ -52,4 +52,16 @@ class Regexps {
         val names = matches.map { it.groupValues[1] }.joinToString()
         assertPrints(names, "Alice, Bob, Eve")
     }
+
+    @Sample
+    fun splitToSequence() {
+        val colors = "green, red , brown&blue, orange, pink&green"
+        val regex = "[,\\s]+".toRegex()
+
+        val mixedColor = regex.splitToSequence(colors)
+            .onEach { println(it) }
+            .firstOrNull { it.contains('&') }
+
+        assertPrints(mixedColor, "brown&blue")
+    }
 }
\ No newline at end of file
diff --git a/libraries/stdlib/samples/test/samples/text/strings.kt b/libraries/stdlib/samples/test/samples/text/strings.kt
index 251bf4baeaa..d4ba7143639 100644
--- a/libraries/stdlib/samples/test/samples/text/strings.kt
+++ b/libraries/stdlib/samples/test/samples/text/strings.kt
@@ -495,4 +495,16 @@ class Strings {
 
         assertPrints("abc".toBooleanStrictOrNull(), "null")
     }
+
+    @Sample
+    fun splitToSequence() {
+        val colors = "green, red , brown&blue, orange, pink&green"
+        val regex = "[,\\s]+".toRegex()
+
+        val mixedColor = colors.splitToSequence(regex)
+            .onEach { println(it) }
+            .firstOrNull { it.contains('&') }
+
+        assertPrints(mixedColor, "brown&blue")
+    }
 }
diff --git a/libraries/stdlib/src/kotlin/text/Strings.kt b/libraries/stdlib/src/kotlin/text/Strings.kt
index e1387c26bc5..fc7e6a8ba6e 100644
--- a/libraries/stdlib/src/kotlin/text/Strings.kt
+++ b/libraries/stdlib/src/kotlin/text/Strings.kt
@@ -1379,6 +1379,7 @@ public inline fun CharSequence.split(regex: Regex, limit: Int = 0): List<String>
  *
  * @param limit Non-negative value specifying the maximum number of substrings to return.
  * Zero by default means no limit is set.
+ * @sample samples.text.Strings.splitToSequence
  */
 @SinceKotlin("1.5")
 @ExperimentalStdlibApi
diff --git a/libraries/stdlib/wasm/src/kotlin/Text.kt b/libraries/stdlib/wasm/src/kotlin/Text.kt
index 4f2036e0664..d89f4619979 100644
--- a/libraries/stdlib/wasm/src/kotlin/Text.kt
+++ b/libraries/stdlib/wasm/src/kotlin/Text.kt
@@ -52,6 +52,7 @@ actual class Regex {
      *
      * @param limit Non-negative value specifying the maximum number of substrings the string can be split to.
      * Zero by default means no limit is set.
+     * @sample samples.text.Regexps.splitToSequence
      */
     public actual fun splitToSequence(input: CharSequence, limit: Int): Sequence<String> = TODO("Wasm stdlib: Text")