Ir para conteúdo principal Pular para conteúdo complementar

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

Argumentos
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:

  • Se field_no for positivo, a função retornará um valor, identificando as correspondências da esquerda para a direita.

  • Se field_no for negativo, a função retornará um valor, identificando correspondências da direita para a esquerda.

Ao usar a função em um script de carregamento:

  • Se a função ExtractRegEx() for usada em uma instrução LOAD e field_no for omitido, a função gerará tantos registros quantas forem as correspondências.

  • Se vários campos forem carregados usando ExtractRegEx() e nenhum deles especificar um argumento field_no, os produtos cartesianos de todas as combinações serão criados.

Ao usar a função em uma expressão de gráfico:

  • Se o field_no for omitido, o valor padrão será 1.

Exemplos de funções
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.

Exemplo 1 – script de carregamento para extrair endereços de e-mail do JSON

Exemplo 2 – script de carregamento para extrair valores numéricos de valores monetários

Exemplo 3 – expressões de gráfico para extrair endereços de e-mail do JSON

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!