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), чтобы она не отображалась пользователям, анализирующим приложение.