Функция replaceBefore

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

Синтаксис

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

Пример

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

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

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

kotlinString "XYZ-de-fgh"

Пример

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

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

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

kotlinString "123de-fgh"

Пример

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

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

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

kotlinString "abcde"

Пример

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

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

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

kotlinString "XYZDe-FgH"

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

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