split

Платформы и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun split(input: CharSequence, limit: Int = 0): List<String>

Разбивает CharSequence input на список строк по совпадениям с этим регулярным выражением.

Последний элемент полученного списка соответствует подстроке input, начинающейся сразу после последнего совпадения (или в начале последовательности символов input, если совпадений не было) и заканчивающейся в конце input. Это означает, что если input не содержит подстрок, соответствующих этому регулярному выражению, полученный список будет содержать один элемент, соответствующий всей последовательности input. Это также означает, что для последовательностей символов, заканчивающихся совпадением с этим регулярным выражением, полученный список будет заканчиваться пустой строкой.

Параметры

Примеры

import kotlin.test.*

fun main() { 
   //sampleStart 
   val colors = "green, red , brown&blue, orange, pink&green"
val regex = "[,\\s]+".toRegex()

val mixedColor = regex.split(colors)
    .onEach { println(it) }
    .firstOrNull { it.contains('&') }

println(mixedColor) // brown&blue

val splitNonMatchingInput = regex.split("Split_me_if_you_can")
println(splitNonMatchingInput) // [Split_me_if_you_can]

val splitSurroundedByMatches = regex.split(",(-.-),")
println(splitSurroundedByMatches) // [, (-.-), ]

println("regex.split(\"\") == listOf(\"\") is ${regex.split("") == listOf("")}") // true 
   //sampleEnd
}