Функция matches

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

Синтаксис

fun String.matches(regex: CharSequence): Boolean

fun String.matches(regex: Regex): Boolean

Пример

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

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

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

Boolean true

Пример

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

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

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

Boolean true

Пример

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

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

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

Boolean true

Пример

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

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

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

Boolean true

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

функцию containsMatchIn,
которая проверяет наличие подстроки, соответствующей регулярному выражению
функцию find,
которая находит первое соответствие регулярному выражению
функцию replace,
которая заменяет соответствия регулярному выражению
функцию split,
которая разделяет строку по регулярному выражению