kotlin-stdlib / kotlin.text / replaceFirst

replaceFirst

Common
JVM
JS
1.0
fun String.replaceFirst(
    oldChar: Char,
    newChar: Char,
    ignoreCase: Boolean = false
): String
Native
1.3
fun String.replaceFirst(
    oldChar: Char,
    newChar: Char,
    ignoreCase: Boolean
): String

Returns a new string with the first occurrence of oldChar replaced with newChar.

Common
JVM
JS
1.0
fun String.replaceFirst(
    oldValue: String,
    newValue: String,
    ignoreCase: Boolean = false
): String
Native
1.3
fun String.replaceFirst(
    oldValue: String,
    newValue: String,
    ignoreCase: Boolean
): String

Returns a new string obtained by replacing the first occurrence of the oldValue substring in this string with the specified newValue string.

Common
JVM
JS
Native
1.0
fun CharSequence.replaceFirst(
    regex: Regex,
    replacement: String
): String

Replaces the first occurrence of the given regular expression regex in this char sequence with specified replacement expression.

Parameters

replacement - A replacement expression that can include substitutions. See Regex.replaceFirst for details.