kotlin-stdlib/kotlin.text/Regex

Regex

expect class Regex : Serializable(source)

Represents a compiled regular expression. Provides functions to match strings in text with a pattern, replace the found occurrences and split text around matches.

For pattern syntax reference see Pattern.

Since Kotlin

1.0

Constructors

Link copied to clipboard
expect constructor(pattern: String)

Creates a regular expression from the specified pattern string and the default options.

expect constructor(pattern: String, option: RegexOption)

Creates a regular expression from the specified pattern string and the specified single option.

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

Creates a regular expression from the specified pattern string and the specified set of options.

Types

Link copied to clipboard
expect object Companion
Since Kotlin 1.0

Properties

Link copied to clipboard
expect val options: Set<RegexOption>

The set of options that were used to create this regular expression.

Since Kotlin 1.0
Link copied to clipboard
expect val pattern: String

The pattern string of this regular expression.

Since Kotlin 1.0

Functions

Link copied to clipboard
expect fun containsMatchIn(input: CharSequence): Boolean

Indicates whether the regular expression can find at least one match in the specified input.

Since Kotlin 1.0
Link copied to clipboard
expect fun find(input: CharSequence, startIndex: Int = 0): MatchResult?

Returns the first match of a regular expression in the input, beginning at the specified startIndex.

Since Kotlin 1.0
Link copied to clipboard
expect fun findAll(input: CharSequence, startIndex: Int = 0): Sequence<MatchResult>

Returns a sequence of all occurrences of a regular expression within the input string, beginning at the specified startIndex.

Since Kotlin 1.0
Link copied to clipboard
expect fun matchEntire(input: CharSequence): MatchResult?

Attempts to match the entire input CharSequence against the pattern.

Since Kotlin 1.0
Link copied to clipboard
expect infix fun matches(input: CharSequence): Boolean

Indicates whether the regular expression matches the entire input.

Since Kotlin 1.0
Link copied to clipboard
expect fun replace(input: CharSequence, transform: (MatchResult) -> CharSequence): String

Replaces all occurrences of this regular expression in the specified input string with the result of the given function transform that takes MatchResult and returns a string to be used as a replacement for that match.

Since Kotlin 1.0
expect fun replace(input: CharSequence, replacement: String): String

Replaces all occurrences of this regular expression in the specified input string with specified replacement expression.

Since Kotlin 1.0
Link copied to clipboard
expect fun replaceFirst(input: CharSequence, replacement: String): String

Replaces the first occurrence of this regular expression in the specified input string with specified replacement expression.

Since Kotlin 1.0
Link copied to clipboard
expect fun split(input: CharSequence, limit: Int = 0): List<String>

Splits the input CharSequence to a list of strings around matches of this regular expression.

Since Kotlin 1.0
Link copied to clipboard
fun toPattern(): Pattern

Returns an instance of Pattern with the same pattern string and options as this instance of Regex has.

Since Kotlin 1.0
Link copied to clipboard
open override fun toString(): String

Returns the string representation of this regular expression, namely the pattern of this regular expression.

Since Kotlin 1.0