replace

inline fun CharSequence.replace(regex: Regex, replacement: String): String(source)

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.

Since Kotlin

1.0

inline fun CharSequence.replace(regex: Regex, noinline transform: (MatchResult) -> CharSequence): String(source)

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.

Since Kotlin

1.0

expect fun String.replace(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String(source)

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

Since Kotlin

1.0

Samples

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

fun main() { 
   //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
}
xxxxxxxxxx
 
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. 
Open in Playground →
Target: JVMRunning on v.2.1.20

expect fun String.replace(oldValue: String, newValue: String, ignoreCase: Boolean = false): String(source)

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

Since Kotlin

1.0

Samples

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

fun main() { 
   //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
}
xxxxxxxxxx
 
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. 
Open in Playground →
Target: JVMRunning on v.2.1.20

actual fun String.replace(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String(source)

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

Since Kotlin

1.1

Samples

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

fun main() { 
   //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
}
xxxxxxxxxx
 
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. 
Open in Playground →
Target: JVMRunning on v.2.1.20

actual fun String.replace(oldValue: String, newValue: String, ignoreCase: Boolean = false): String(source)

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

Since Kotlin

1.1

Samples

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

fun main() { 
   //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
}
xxxxxxxxxx
 
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. 
Open in Playground →
Target: JVMRunning on v.2.1.20

actual fun String.replace(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String(source)

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

Since Kotlin

1.0

Samples

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

fun main() { 
   //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
}
xxxxxxxxxx
 
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. 
Open in Playground →
Target: JVMRunning on v.2.1.20

actual fun String.replace(oldValue: String, newValue: String, ignoreCase: Boolean = false): String(source)

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

Since Kotlin

1.0

Samples

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

fun main() { 
   //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
}
xxxxxxxxxx
 
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. 
Open in Playground →
Target: JVMRunning on v.2.1.20

actual fun String.replace(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String(source)

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

Since Kotlin

1.3

Samples

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

fun main() { 
   //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
}
xxxxxxxxxx
 
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. 
Open in Playground →
Target: JVMRunning on v.2.1.20

actual fun String.replace(oldValue: String, newValue: String, ignoreCase: Boolean = false): String(source)

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

Since Kotlin

1.3

Samples

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

fun main() { 
   //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
}
xxxxxxxxxx
 
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. 
Open in Playground →
Target: JVMRunning on v.2.1.20

Thanks for your feedback!

Was this page helpful?