Функция replaceFirst

Функция replaceFirst заменяет первое вхождение указанной подстроки oldValue на новую подстроку newValue в исходной строке. Возвращает новую строку с выполненной заменой. Если искомая подстрока не найдена, возвращается исходная строка без изменений.

Синтаксис

kotlinfun String.replaceFirst(oldValue: String, newValue: String): String

kotlinfun String.replaceFirst(
  oldValue: String, 
  newValue: String, 
  ignoreCase: Boolean = false
): String

Пример

Заменим первое вхождение подстроки "bc" на "XY" в строке "abcde bcd":

kotlinval str = "abcde bcd"
val res = str.replaceFirst("bc", "XY")
println(res)

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

kotlinString "aXYde bcd"

Пример

Заменим первое вхождение подстроки "BC" с учетом регистра на "XY":

kotlinval str = "abcde BCD"
val res = str.replaceFirst("BC", "XY", ignoreCase = true)
println(res)

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

kotlinString "aXYde BCD"

Пример

Если искомая подстрока не найдена в исходной строке, функция возвращает исходную строку без изменений:

kotlinval str = "abcde"
val res = str.replaceFirst("xyz", "123")
println(res)

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

kotlinString "abcde"

Пример

Заменим первое вхождение цифры "1" на "9" в строке с числами:

kotlinval str = "12345 12345"
val res = str.replaceFirst("1", "9")
println(res)

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

kotlinString "92345 12345"

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