Перейти к основному содержимому Перейти к дополнительному содержимому

ReplaceRegExGroup — функция скриптa и диаграммы

ReplaceRegExGroup() возвращает строку после замены одного или нескольких совпадений между входной строкой и заданным шаблоном составного регулярного выражения. Текст, который заменяет совпадающий текст, указан в аргументе to_str. Функция работает слева направо, но если задано отрицательное значение occurrence, функция читает справа налево.

Эта функция выполняет операции с регулярными выражениями, чувствительные к регистру. В качестве альтернативы можно использовать вариант ReplaceRegExGroupI() для выполнения операций с регулярными выражениями без учета регистра.

Синтаксис:  

ReplaceRegExGroup (text, regex, to_str, group [, occurrence])

Возвращаемые типы данных: строка

Аргументы
Аргумент Описание
text Текст входной строки, который требуется полностью или частично заменить новым текстом из to_str.
regex Регулярное выражение, определяющее, когда заменять текст. Заменяются совпадения между этим аргументом и аргументом text.
to_str Новый текст, который требуется использовать для замены существующего содержимого из text.
group

Номер группы в случае составного регулярного выражения.

Если регулярное выражение содержит только одну группу, используйте вместо этого функцию ReplaceRegEx(). В качестве альтернативы используйте функцию ReplaceRegExGroup() с group=0.

Можно указать отрицательное значение group для поиска совпадений справа налево.

occurrence

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

Данный аргумент является необязательным. По умолчанию 0, если опущено. Когда используется значение 0 или если аргумент опущен, все совпадения между text и regex заменяются на to_str.

Можно указать отрицательное значение для occurrence, если требуется искать совпадения справа налево.

Примеры функции
Пример Результат
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',0) Возвращает abx (замена полного совпадения).
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',1) Возвращает abx123 (заменяет только первую группу в совпадении).
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',2) Возвращает abcx (заменяет только вторую группу в совпадении).
ReplaceRegExGroup('abc123abc123','([a-z])([0-9]+)','x',1,2) Возвращает abc123abx123. Есть два совпадения между первой группой входного текста и шаблоном регулярного выражения. Однако заменяется только второе вхождение.
ReplaceRegExGroup('ABC123ABC123','([a-z])([0-9]+)','x',1) Возвращает ABC123ABC123. Другими словами, замена текста не выполняется. Это объясняется тем, что функция учитывает регистр, а вариант функции без учета регистра не используется.
ReplaceRegExGroupI('ABC123ABC123','([a-z])([0-9]+)','x',1) Возвращает ABx123ABx123. В этом примере замена текста происходит потому, что используется нечувствительный к регистру вариант функции, ReplaceRegExGroupI().

Когда это следует использовать

Можно использовать ReplaceRegExGroup() для изменения текста с учетом стандартов форматирования и соответствия, особенно когда требуется определить в данных сложные шаблоны. Дополнительный аргумент group для этой функции позволяет обновлять только определенные части большого текстового шаблона. Например, можно обновлять определенные части URL-адреса.

При необходимости также можно использовать эту функцию для маскирования конфиденциальной информации, такой как персональная идентифицирующая информация (PII), чтобы она не отображалась пользователям, анализирующим приложение.

Пример 1: скрипт загрузки для обновления домена в URL-адресах

Пример 2: выражение диаграммы для обновления протокола в URL-адресах

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!