Функция matches

Функция matches проверяет соответствие всей строки заданному регулярному выражению. В первый параметр передается регулярное выражение в виде строки или объекта Regex. Функция возвращает true, если вся строка соответствует шаблону, и false в противном случае.

Синтаксис

kotlinfun String.matches(regex: CharSequence): Boolean

kotlinfun String.matches(regex: Regex): Boolean

Пример

Проверим, соответствует ли строка "abc123" шаблону буквенно-цифровых символов:

kotlinval str = "abc123"
val res = str.matches("[a-zA-Z0-9]+".toRegex())
println(res)

Результат выполнения кода:

kotlinBoolean true

Пример

Проверим, является ли строка числом:

kotlinval str = "12345"
val res = str.matches("\\d+".toRegex())
println(res)

Результат выполнения кода:

kotlinBoolean true

Пример

Проверим, соответствует ли строка шаблону даты в формате DD.MM.YYYY:

kotlinval date = "31.12.2023"
val pattern = "\\d{2}\.\d{2}\.\d{4}".toRegex()
val res = date.matches(pattern)
println(res)

Результат выполнения кода:

kotlinBoolean true

Пример

Использование предварительно скомпилированного регулярного выражения:

kotlinval regex = Regex("[A-Z][a-z]+")
val str = "Kotlin"
val res = str.matches(regex)
println(res)

Результат выполнения кода:

kotlinBoolean true

Смотрите также