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

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

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

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

Синтаксис:  

ReplaceRegEx (text, regex, to_str [, occurrence])

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

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

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

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

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

Примеры функции
Пример Результат
ReplaceRegEx('abc123','[0-9]','x') Возвращает abcxxx. В этом примере весь текст из входной строки, соответствующий шаблону регулярного выражения, заменяется новым текстом.
ReplaceRegEx('abc123','[0-9]','x',1) Возвращает abcx23. Заменяются только первые вхождения совпадения между входной строкой и шаблоном регулярного выражения.
ReplaceRegEx('abc123','[0-9]','x',4) Возвращает abc123. Существует только три возможных совпадения между входной строкой и шаблоном регулярного выражения, поэтому изменение не выполняется.
ReplaceRegEx('ABC123','[a-c]','5') Возвращает ABC123. Изменение не выполняется, поскольку функция ReplaceRegEx() учитывает регистр, а вариант без учета регистра не используется.
ReplaceRegExI('ABC123','[a-c]','5') Возвращает 555123. Используется вариант функции ReplaceRegExI() без учета регистра.

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

Можно использовать ReplaceRegEx() для изменения текста с учетом стандартов форматирования и соответствия, особенно когда в данных присутствуют сложные шаблоны. Например, можно переформатировать строки телефонных номеров так, чтобы в них были включены только числовые значения.

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

Пример 1: скрипт загрузки для обновления адресов электронной почты сотрудников

Пример 2: скрипт загрузки для форматирования кодов ISBN

Пример 3: выражение диаграммы для обновления дополнительных адресов электронной почты

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

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