replaceFirst

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

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

Для JVM

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

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

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

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

Параметры

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

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

Исключения

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

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

Для JS

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

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

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

Обратите внимание, что ссылка на именованные захваченные группы по имени в настоящее время не поддерживается в Kotlin/JS. Однако вы всё ещё можете ссылаться на них по индексу.

Параметры

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

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

Исключения

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

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

Для Native

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

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

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

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

Параметры

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

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

Исключения

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

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