Функция replaceBefore

Функция replaceBefore заменяет часть строки до первого вхождения указанного разделителя. В первый параметр передается разделитель delimiter, во второй параметр replacement - строка для замены. Возвращает новую строку с выполненной заменой.

Синтаксис

fun String.replaceBefore(
	delimiter: String, 
	replacement: String, 
	ignoreCase: Boolean = false
): String

fun String.replaceBefore(
	delimiter: Char, 
	replacement: String, 
	ignoreCase: Boolean = false
): String

Пример

Заменим часть строки до первого вхождения символа '-':

val str = "abc-de-fgh"
val res = str.replaceBefore('-', "XYZ")
println(res)

Результат выполнения кода:

String "XYZ-de-fgh"

Пример

Заменим часть строки до первого вхождения подстроки "de":

val str = "abc-de-fgh"
val res = str.replaceBefore("de", "123")
println(res)

Результат выполнения кода:

String "123de-fgh"

Пример

Если разделитель не найден в строке, возвращается исходная строка:

val str = "abcde"
val res = str.replaceBefore('z', "XYZ")
println(res)

Результат выполнения кода:

String "abcde"

Пример

Использование регистронезависимого поиска с параметром ignoreCase:

val str = "aBc-De-FgH"
val res = str.replaceBefore("d", "XYZ", ignoreCase = true)
println(res)

Результат выполнения кода:

String "XYZDe-FgH"

Смотрите также

функцию replaceAfter,
которая заменяет часть строки после разделителя
функцию replace,
которая заменяет все вхождения подстроки
функцию replaceFirst,
которая заменяет первое вхождение подстроки
функцию substring,
которая извлекает часть строки