replace

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

fun replace(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

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

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

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

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

Параметры

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

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

Исключения

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

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

Для Native

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

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

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

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

Параметры

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

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

Исключения

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

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

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

fun replace(
    input: CharSequence, 
    transform: (MatchResult) -> CharSequence
): String

Заменяет все вхождения этого регулярного выражения в указанной строке input результатом применения заданной функции transform, которая принимает MatchResult и возвращает строку, используемую в качестве замены для данного совпадения.