ExtractRegEx – função de script e gráfico
ExtractRegEx() extrai texto de uma expressão de string de entrada usando o padrão de expressão regular especificado. A função retorna um valor nulo se nenhuma correspondência for encontrada.
Essa função executa operações regex que diferenciam maiúsculas de minúsculas. Como alternativa, você pode usar a variante ExtractRegExI() para realizar operações de regex sem distinção entre maiúsculas e minúsculas.
Sintaxe:
ExtractRegEx (text, regex [, field_no])
Tipo de dados de retorno: caractere
Argumento | Descrição |
---|---|
text | Expressão de string que contém o texto a ser extraído no valor de retorno. |
regex | A expressão regular a ser usada para extrair o texto. |
field_no |
O número da correspondência a ser extraída. Isso é útil quando várias correspondências para a expressão regular podem ser encontradas no texto. Por exemplo, especifique um valor de 4 para extrair a quarta correspondência. Este é um argumento opcional. Especifique um valor negativo para inverter a ordem das correspondências. Os itens a seguir se aplicam independentemente de a função ser usada em um script de carregamento ou em uma expressão de gráfico:
Ao usar a função em um script de carregamento:
Ao usar a função em uma expressão de gráfico:
|
Exemplo | Resultado |
---|---|
ExtractRegEx('a,b c;1 2,3','[a-z]|[0-9]', 1) | Retorna a, que é a primeira correspondência encontrada. |
ExtractRegEx('a,b c;1 2,3','[a-z]|[0-9]', 2) | Retorna b, que é a segunda correspondência encontrada. |
ExtractRegEx('a,b c;1 2,3','[a-z]|[0-9]', 4) | Retorna 1, que é a quarta correspondência encontrada. |
ExtractRegEx('abc','a|b',-1) | Retorna b. Quando um valor negativo é especificado, as correspondências são contadas de forma inversa. |
ExtractRegEx('A,B C;1 2,3','[a-c]|[4-9]') | Retorna um valor nulo, pois ExtractRegEx() diferencia maiúsculas de minúsculas e a variante que não diferencia maiúsculas de minúsculas não foi usada. |
ExtractRegExI('A,B C;1 2,3','[a-c]|[4-9]') | Retorna A, porque a variante que não diferencia maiúsculas de minúsculas ExtractRegExI() foi usada. |
Quando usar
Você pode usar Extract RegEx() para extrair informações que deseja isolar de dados que também podem conter outras informações (por exemplo, texto livre ou strings JSON). Por exemplo:
-
Extraia endereços de e-mail, números de telefone, números de conta e outras informações do texto.
-
Extraia valores numéricos do texto (por exemplo, moeda).
-
Padronize a formatação de dados numéricos ou de texto.