replaceFirst

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

fun replaceFirst(
    input: CharSequence, 
    replacement: String
): String

Для JVM

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

Строка замены может содержать ссылки на захваченные группы во время соответствия. Вхождения ${name} или $index в строке замены будут заменены подстроками, соответствующими захваченным группам с указанным именем или индексом. В случае $index, первая цифра после '$' всегда обрабатывается как часть ссылки на группу. Последующие цифры включаются в index только в том случае, если они сформируют корректную ссылку на группу. Только цифры '0'..'9' рассматриваются как потенциальные компоненты ссылки на группу. Обратите внимание, что индексы захваченных групп начинаются с 1, а группа с индексом 0 — это всё совпадение.

В случае ${name}, name может состоять из латинских букв 'a'..'z' и 'A'..'Z' или цифр '0'..'9'. Первый символ должен быть буквой.

Символ обратного слэша '\' может использоваться для включения последующего символа в качестве символа в строке замены, например, \$ или \\. Regex.escapeReplacement может использоваться, если replacement должна обрабатываться как строка-литерал.

Обратите внимание, что именованные захватывающие группы поддерживаются в Java 7 и новее.

Параметры

input - последовательность символов для поиска совпадения этого регулярного выражения в

replacement - выражение для замены найденного совпадения

Исключения

RuntimeException - если выражение replacement имеет неправильный формат или захватывающая группа с указанным name или index не существует

Возвращаемое значение результат замены первого вхождения этого регулярного выражения в input на результат вычисления выражения replacement

Для JS, Native

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

Строка замены может содержать ссылки на захваченные группы во время соответствия. Вхождения ${name} или $index в строке замены будут заменены подстроками, соответствующими захваченным группам с указанным именем или индексом. В случае $index, первая цифра после '$' всегда обрабатывается как часть ссылки на группу. Последующие цифры включаются в index только в том случае, если они сформируют корректную ссылку на группу. Только цифры '0'..'9' рассматриваются как потенциальные компоненты ссылки на группу. Обратите внимание, что индексы захваченных групп начинаются с 1, а группа с индексом 0 — это всё совпадение.

В случае ${name}, name может состоять из латинских букв 'a'..'z' и 'A'..'Z' или цифр '0'..'9'. Первый символ должен быть буквой.

Символ обратного слэша '\' может использоваться для включения последующего символа в качестве символа в строке замены, например, \$ или \\. Regex.escapeReplacement может использоваться, если replacement должна обрабатываться как строка-литерал.

Параметры

input - последовательность символов для поиска совпадения этого регулярного выражения в

replacement - выражение для замены найденного совпадения

Исключения

RuntimeException - если выражение replacement имеет неправильный формат или захватывающая группа с указанным name или index не существует

Возвращаемое значение результат замены первого вхождения этого регулярного выражения в input на результат вычисления выражения replacement