replace

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

Returns a new string with all occurrences of oldChar replaced with newChar.

import java.util.Locale
import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val inputString0 = "Mississippi"
val inputString1 = "Insufficient data for meaningful answer."

println(inputString0.replace('s', 'z')) // Mizzizzippi
println(inputString1.replace("data", "information")) // Insufficient information for meaningful answer.
//sampleEnd
}
Common
JVM
JS
1.0
fun String.replace(
    oldValue: String,
    newValue: String,
    ignoreCase: Boolean = false
): String
Native
1.3
fun String.replace(
    oldValue: String,
    newValue: String,
    ignoreCase: Boolean
): String

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

import java.util.Locale
import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val inputString0 = "Mississippi"
val inputString1 = "Insufficient data for meaningful answer."

println(inputString0.replace('s', 'z')) // Mizzizzippi
println(inputString1.replace("data", "information")) // Insufficient information for meaningful answer.
//sampleEnd
}
Common
JVM
JS
Native
1.0
fun CharSequence.replace(
    regex: Regex,
    replacement: String
): String

Returns a new string obtained by replacing each substring of this char sequence that matches the given regular expression with the given replacement.

The replacement can consist of any combination of literal text and $-substitutions. To treat the replacement string literally escape it with the kotlin.text.Regex.Companion.escapeReplacement method.

Common
JVM
JS
Native
1.0
inline fun CharSequence.replace(
    regex: Regex,
    noinline transform: (MatchResult) -> CharSequence
): String

Returns a new string obtained by replacing each substring of this char sequence that matches the given regular expression with the result of the given function transform that takes MatchResult and returns a string to be used as a replacement for that match.