Функция replaceFirst

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

Синтаксис

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

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

Пример

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

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

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

String "aXYde bcd"

Пример

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

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

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

String "aXYde BCD"

Пример

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

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

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

String "abcde"

Пример

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

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

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

String "92345 12345"

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

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