ExtractRegEx — функция скриптa и диаграммы
ExtractRegEx() извлекает текст из входного строкового выражения, используя указанный шаблон регулярного выражения. Функция возвращает нулевое значение, если не найдено ни одного совпадения.
Эта функция выполняет операции с регулярными выражениями, чувствительные к регистру. В качестве альтернативы можно использовать вариант ExtractRegExI() для выполнения операций с регулярными выражениями без учета регистра.
Синтаксис:
ExtractRegEx (text, regex [, field_no])
Возвращаемые типы данных: строка
Аргумент | Описание |
---|---|
text | Строковое выражение, содержащее текст, который будет извлечен в возвращаемое значение. |
regex | Регулярное выражение, которое будет использоваться для извлечения текста. |
field_no |
Номер совпадения, которое нужно извлечь. Это полезно, когда в тексте может быть найдено несколько совпадений с регулярным выражением. Например, укажите значение 4, чтобы извлечь четвертое совпадение. Данный аргумент является необязательным. Укажите отрицательное значение, чтобы изменить порядок совпадений на обратный. Следующие правила применяются независимо от того, используется функция в скрипте загрузки или выражении диаграммы:
При использовании функции в скрипте загрузки:
При использовании функции в выражениях диаграммы:
|
Пример | Результат |
---|---|
ExtractRegEx('a,b c;1 2,3','[a-z]|[0-9]', 1) | Возвращает a, то есть первое найденное совпадение. |
ExtractRegEx('a,b c;1 2,3','[a-z]|[0-9]', 2) | Возвращает b, то есть второе найденное совпадение. |
ExtractRegEx('a,b c;1 2,3','[a-z]|[0-9]', 4) | Возвращает 1, то есть четвертое найденное совпадение. |
ExtractRegEx('abc','a|b',-1) | Возвращает b. Если задано отрицательное значение, подсчет совпадений ведется в обратном порядке. |
ExtractRegEx('A,B C;1 2,3','[a-c]|[4-9]') | Возвращает нулевое значение, так как ExtractRegEx() учитывает регистр, а вариант без учета регистра не использовался. |
ExtractRegExI('A,B C;1 2,3','[a-c]|[4-9]') | Возвращает A, поскольку был использован вариант ExtractRegExI(), не учитывающий регистр. |
Когда это следует использовать
Можно использовать Extract RegEx() для извлечения информации, которую требуется изолировать от данных, которые могут также содержать другую информацию (например, произвольный текст или строки JSON). Пример.
-
Извлекайте из текста адреса электронной почты, номера телефонов, номера счетов и другую информацию.
-
Извлекайте из текста числовые значения (например, денежные суммы).
-
Стандартизируйте форматирование текстовых или числовых данных.