group
Начиная с Kotlin: 1.0
abstract val groupValues: List<String>
Список значений совпавших индексированных групп.
Размер этого списка равен groupCount + 1, где groupCount — количество групп в регулярном выражении. Группы индексируются от 1 до groupCount, а группа с индексом 0 соответствует совпадению целиком.
Если группа в регулярном выражении является необязательной и она ничего не захватила, соответствующий элемент в groupValues представляет собой пустую строку.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
val inputString = "John 9731879"
val match = Regex("(\\w+) (\\d+)").find(inputString)!!
val [name, phone] = match.destructured
println(name) // John // value of the first group matched by \w+
println(phone) // 9731879 // value of the second group matched by \d+
// group with the zero index is the whole substring matched by the regular expression
println(match.groupValues) // [John 9731879, John, 9731879]
val numberedGroupValues = match.destructured.toList()
// destructured group values only contain values of the groups, excluding the zeroth group.
println(numberedGroupValues) // [John, 9731879]
//sampleEnd
}
© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.text/-match-result/group-values.html
