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

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

SubFieldRegEx() extrai texto de uma expressão de string de entrada, usando o padrão de expressão regular especificado como delimitador. 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 SubFieldRegExI() para realizar operações de regex sem distinção entre maiúsculas e minúsculas.

Sintaxe:  

SubFieldRegEx (text, regex_delimiter [, field_no])

Tipo de dados de retorno: caractere

Argumentos
Argumento Descrição
text O texto da string de entrada na qual você deseja procurar um padrão de expressão regular.
regex_delimiter Expressão de string contendo a expressão regular a ser usada como delimitador. Você pode especificar mais de um delimitador no mesmo padrão de expressão regular, separando-os com um caractere | (tubo vertical).
field_no

Valor inteiro que indica o número da subdivisão que você deseja extrair. Por exemplo, especifique um valor de 4 para extrair a quarta subdivisão. Este é um argumento opcional.

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 SubFieldRegEx() 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 SubFieldRegEx() 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
SubFieldRegEx('a,b c;1 2,3',' |,|;', 1) Retorna a. Neste exemplo, são especificados três caracteres delimitadores (espaço, vírgula e ponto e vírgula).
SubFieldRegEx('a;b;c;1;2;3',';', 2) Retorna b. Nesse caso, apenas um caractere delimitador é especificado (ponto e vírgula).
SubFieldRegEx('a,b c;1 2,3',' |,|;', 4) Retorna 1.

Quando usar

Você pode usar SubFieldRegEx() para extrair vários valores individuais de uma lista delimitada. Por exemplo, se você tiver uma lista separada por vírgulas contida em um bloco maior de linguagem natural, poderá usar esta função para isolar cada valor individual da lista em um novo registro no seu modelo de dados.

Exemplo 1 – script de carregamento para separar tags por transação

Exemplo 2 – expressões de gráfico para separar tags por transação

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!