W3cubDocs

/Kotlin

Regex

Platform and version requirements: JS (1.1), Native (1.3)
class Regex
Platform and version requirements: JVM (1.0)
class Regex : Serializable
For JVM

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.

For JS

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 MDN RegExp and http://www.w3schools.com/jsref/jsref_obj_regexp.asp.

For Native

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

Constructors

Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

<init>

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

<init>(pattern: String)

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

<init>(pattern: String, option: RegexOption)

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

<init>(pattern: String, options: Set<RegexOption>)

Properties

Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

options

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

val options: Set<RegexOption>
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

pattern

The pattern string of this regular expression.

val pattern: String

Functions

Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

containsMatchIn

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

fun containsMatchIn(input: CharSequence): Boolean

find

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

Platform and version requirements: JVM (1.0), JS (1.1)
fun find(
    input: CharSequence, 
    startIndex: Int = 0
): MatchResult?
Platform and version requirements: Native (1.3)
fun find(input: CharSequence, startIndex: Int): MatchResult?

findAll

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

Platform and version requirements: JVM (1.0), JS (1.1)
fun findAll(
    input: CharSequence, 
    startIndex: Int = 0
): Sequence<MatchResult>
Platform and version requirements: Native (1.3)
fun findAll(
    input: CharSequence, 
    startIndex: Int
): Sequence<MatchResult>
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

matchEntire

Attempts to match the entire input CharSequence against the pattern.

fun matchEntire(input: CharSequence): MatchResult?
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

matches

Indicates whether the regular expression matches the entire input.

infix fun matches(input: CharSequence): Boolean
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

replace

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

fun replace(input: CharSequence, replacement: String): 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.

fun replace(
    input: CharSequence, 
    transform: (MatchResult) -> CharSequence
): String
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

replaceFirst

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

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

split

Splits the input CharSequence around matches of this regular expression.

Platform and version requirements: JVM (1.0), JS (1.1)
fun split(input: CharSequence, limit: Int = 0): List<String>
Platform and version requirements: Native (1.3)
fun split(input: CharSequence, limit: Int): List<String>
Platform and version requirements: JVM (1.0)

toPattern

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

fun toPattern(): Pattern
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

toString

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

fun toString(): String

Companion Object Functions

Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

escape

Returns a regular expression pattern string that matches the specified literal string literally. No characters of that string will have special meaning when searching for an occurrence of the regular expression.

fun escape(literal: String): String
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

escapeReplacement

Returns a literal replacement expression for the specified literal string. No characters of that string will have special meaning when it is used as a replacement string in Regex.replace function.

fun escapeReplacement(literal: String): String
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)

fromLiteral

Returns a regular expression that matches the specified literal string literally. No characters of that string will have special meaning when searching for an occurrence of the regular expression.

fun fromLiteral(literal: String): Regex

© 2010–2020 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/index.html