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

ExtractRegExGroup – função de script e gráfico

ExtractRegExGroup() extrai texto de uma expressão de string de entrada usando o padrão de expressão regular composta especificado. Ao usar a função, especifique o grupo a ser usado na regex composta. A função retorna um valor nulo se nenhuma correspondência for encontrada.

Se você usar a função ExtractRegExGroup() em uma instrução LOAD, e field_no for omitido, a função retornará vários registros. Se vários campos forem carregados usando ExtractRegExGroup(), os produtos cartesianos de todas as combinações serão criados.

Essa função executa operações regex que diferenciam maiúsculas de minúsculas. Como alternativa, você pode usar a variante ExtractRegExGroupI() para realizar operações de regex sem distinção entre maiúsculas e minúsculas.

Sintaxe:  

ExtractRegExGroup (text, regex, group [, 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.
group

O número do grupo, no caso de uma expressão regular composta.

Se a expressão regular contiver apenas um grupo, use a função ExtractRegEx() em vez disso. Como alternativa, use ExtractRegExGroup() com um valor para group de 0.

Você pode especificar um valor negativo em group para pesquisar correspondências da direita para a esquerda.

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. O padrão é 1 se não for especificado.

Exemplos de funções
Exemplo Resultado
ExtractRegExGroup('abc123 def456','([a-z]+)([0-9]+)',1) Retorna abc (primeiro grupo da primeira correspondência).
ExtractRegExGroup('abc123 def456','([a-z]+)([0-9]+)',1,2) Retorna def (primeiro grupo da segunda correspondência).
ExtractRegExGroup('abc123 def456','([a-z]+)([0-9]+)',2) Retorna 123 (segundo grupo da primeira correspondência).
ExtractRegExGroup('abc123 def456','([a-z]+)([0-9]+)',2,2) Retorna 456 (segundo grupo da segunda correspondência).

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 analisar códigos de transação

Exemplo 2 – script de carregamento para extrair informações de contato comercial

Exemplo 3 – script de carregamento para extrair componentes de códigos ISBN

Exemplo 4 – expressões de gráfico para extrair informações de contato comercial (com comparação de ExtractRegEx())

Exemplo 5 – Análise de URL (com comparação de ExtractRegEx())

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!