Regex

Требования к платформе и версии: Common (1.0)

expect class Regex(pattern: String, options: Set<RegexOption>)

Представляет скомпилированное регулярное выражение. Предоставляет функции для сопоставления строк в тексте с шаблоном, замены найденных вхождений и разделения текста по совпадениям.

Обратите внимание, что синтаксис шаблона и набор параметров различаются на разных платформах. Подробности см. в документации Regex для соответствующей платформы.

Требования к платформе и версии: JS (1.1)

actual class Regex(pattern: String, options: Set<RegexOption>)

Описание синтаксиса шаблонов см. в MDN RegExp и http://www.w3schools.com/jsref/jsref_obj_regexp.asp.

Обратите внимание, что объекты RegExp внутри создаются с флагом "u", который включает поддержку Unicode в регулярных выражениях. Это также делает синтаксис шаблонов более строгим, например запрещая ненужные escape-последовательности.

Требования к платформе и версии: JVM (1.0)

actual class Regex(pattern: String, options: Set<RegexOption>) : Serializable

Описание синтаксиса шаблонов см. в документации Pattern.

Требования к платформе и версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual class Regex(pattern: String, options: Set<RegexOption>)

Обратите внимание, что в будущем поведение функций сопоставления и замены регулярных выражений может быть изменено, чтобы соответствовать реализации JVM там, где существуют различия.

Конструкторы

Regex

expect constructor(pattern: String)

Создает регулярное выражение из указанной строки шаблона с параметрами по умолчанию.

expect constructor(pattern: String, option: RegexOption)

Создает регулярное выражение из указанной строки шаблона с указанным параметром option.

expect constructor(pattern: String, options: Set<RegexOption>)

Создает регулярное выражение из указанной строки шаблона с указанным набором параметров.

Типы

Companion

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect object Companion

Свойства

options

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect val options: Set<RegexOption>

Набор параметров, использованных для создания этого регулярного выражения.

pattern

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect val pattern: String

Строка шаблона этого регулярного выражения.

Функции

containsMatchIn

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun containsMatchIn(input: CharSequence): Boolean

Показывает, может ли регулярное выражение найти хотя бы одно совпадение в указанном input.

find

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

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

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

findAll

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun findAll(input: CharSequence, startIndex: Int = 0): Sequence<MatchResult>

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

matchAt

Требования к платформе и версии: Common (1.7), JS (1.7), JVM (1.7), Native (1.7), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun matchAt(input: CharSequence, index: Int): MatchResult?

Пытается сопоставить регулярное выражение точно с указанной позиции index во входной последовательности символов input.

matchEntire

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun matchEntire(input: CharSequence): MatchResult?

Пытается сопоставить всю последовательность символов input с шаблоном.

matches

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect infix fun matches(input: CharSequence): Boolean

Показывает, совпадает ли регулярное выражение со всей строкой input.

matchesAt

Требования к платформе и версии: Common (1.7), JS (1.7), JVM (1.7), Native (1.7), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun matchesAt(input: CharSequence, index: Int): Boolean

Проверяет, совпадает ли регулярное выражение с частью указанной последовательности символов input точно в заданной позиции index.

replace

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun replace(input: CharSequence, transform: (MatchResult) -> CharSequence): String

Заменяет все совпадения этого регулярного выражения в указанной строке input результатом заданной функции transform, которая принимает MatchResult и возвращает строку для замены соответствующего совпадения.

expect fun replace(input: CharSequence, replacement: String): String

Заменяет все совпадения этого регулярного выражения в указанной строке input заданным выражением replacement.

replaceFirst

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun replaceFirst(input: CharSequence, replacement: String): String

Заменяет первое совпадение этого регулярного выражения в указанной строке input заданным выражением replacement.

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>

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

splitToSequence

Требования к платформе и версии: Common (1.6), JS (1.6), JVM (1.6), Native (1.6), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun splitToSequence(input: CharSequence, limit: Int = 0): Sequence<String>

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

toPattern

Требования к платформе и версии: JVM (1.0)

fun toPattern(): Pattern

Возвращает экземпляр Pattern с той же строкой шаблона и параметрами, что и у этого экземпляра Regex.

toString

Требования к платформе и версии: JS (1.1)

open override fun toString(): String

Возвращает строковое представление этого регулярного выражения, а именно его шаблон.

Требования к платформе и версии: JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

open override fun toString(): String

Возвращает строковое представление этого регулярного выражения, а именно его шаблон.

© 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/-regex/index.html