find

fun find(
    input: CharSequence, 
    startIndex: Int = 0
): MatchResult?

fun find(input: CharSequence, startIndex: Int): MatchResult?

Для JVM

Возвращает первое совпадение регулярного выражения в входных данных, начиная с указанного startIndex.

Параметры

startIndex - Индекс, с которого начинается поиск, по умолчанию 0. Должен быть не меньше нуля и не больше input.length()

Возвращаемое значение Экземпляр MatchResult, если совпадение найдено, или null в противном случае.

Для JS, Native

Возвращает первое совпадение регулярного выражения в входных данных, начиная с указанного startIndex.

Параметры

startIndex - Индекс, с которого начинается поиск, по умолчанию 0. Должен быть не меньше нуля и не больше input.length()

Исключения

IndexOutOfBoundsException - если startIndex меньше нуля или больше длины последовательности символов входных данных.

Возвращаемое значение Экземпляр MatchResult, если совпадение найдено, или null в противном случае.

Для Common

Возвращает первое совпадение регулярного выражения в входных данных, начиная с указанного startIndex.

fun main(args: Array<String>) {
//sampleStart
val inputString = "to be or not to be"
val regex = "to \\w{2}".toRegex()
// If there is matching string, then find method returns non-null MatchResult
val match = regex.find(inputString)!!
println(match.value) // to be
println(match.range) // 0..4

val nextMatch = match.next()!!
println(nextMatch.range) // 13..17

val regex2 = "this".toRegex()
// If there is no matching string, then find method returns null
println(regex2.find(inputString)) // null

val regex3 = regex
// to be or not to be
//              ^^^^^
// Because the search starts from the index 2, it finds the last "to be".
println(regex3.find(inputString, 2)!!.range) // 13..17
//sampleEnd
}

Параметры

startIndex - Индекс, с которого начинается поиск, по умолчанию 0. Должен быть не меньше нуля и не больше input.length()

Возвращаемое значение Экземпляр MatchResult, если совпадение найдено, или null в противном случае.