replace

Требования к платформе и версии: Common (1.0)

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

Заменяет все вхождения заданного регулярного выражения regex в этой последовательности символов на указанное выражение replacement.

Это вспомогательная функция, эквивалентная regex.replace(this, replacement). Подробнее о её поведении и синтаксисе подстановки выражения replacement см. в документации Regex.replace.

Примеры

import kotlin.test.*

fun main() { 
   //sampleStart 
   val text = "The events are on 15-09-2024 and 16-10-2024."
// Regex to match dates in dd-mm-yyyy format
val dateRegex = "(?<day>\\d{2})-(?<month>\\d{2})-(?<year>\\d{4})".toRegex()
// Replacement expression that puts day, month and year values in the ISO 8601 recommended yyyy-mm-dd format
val replacement = "\${year}-\${month}-\${day}"

// Replacing all occurrences of dates from dd-mm-yyyy to yyyy-mm-dd format
println(text.replace(dateRegex, replacement)) // The events are on 2024-09-15 and 2024-10-16.

// One can also reference the matched groups by index
println(text.replace(dateRegex, "$3-$2-$1")) // The events are on 2024-09-15 and 2024-10-16.

// Using a backslash to include the special character '$' as a literal in the result
println(text.replace(dateRegex, "$3-\\$2-$1")) // The events are on 2024-\$2-15 and 2024-\$2-16. 
   //sampleEnd
}

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

Возвращает новую строку, полученную заменой каждой подстроки этой последовательности символов, соответствующей заданному регулярному выражению, результатом заданной функции transform, которая принимает MatchResult и возвращает строку, используемую для замены этого совпадения.

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

Возвращает новую строку, в которой все вхождения oldChar заменены на newChar.

Примеры

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
}

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

Возвращает новую строку, полученную заменой всех вхождений подстроки oldValue в этой строке на указанную строку newValue.

Примеры

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
}

Требования к платформе и версии: JS (1.1), JVM (1.0), Native (1.3)

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

Возвращает новую строку, в которой все вхождения oldChar заменены на newChar.

Примеры

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
}

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

Примеры

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
}

Требования к платформе и версии: Wasm-JS (1.8), Wasm-WASI (1.8)

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

Возвращает новую строку, в которой все вхождения oldChar заменены на newChar.

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

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