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

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

IndexRegEx() pesquisa a string de entrada e retorna a posição inicial da enésima ocorrência do padrão de expressão regular especificado. Um terceiro argumento opcional count fornece o valor de n, que é 1 se for omitido. As posições na string são numeradas da esquerda para a direita, de 1 para cima. Se nenhuma correspondência for encontrada, a função retornará 0.

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

Sintaxe:  

IndexRegEx (text, regex [, count])

Tipo de dados de retorno: inteiro

Argumentos
Argumento Descrição
text O texto da string de entrada na qual você deseja procurar uma expressão regular.
regex A expressão regular a ser usada para pesquisar a string de entrada.
count

O número da correspondência. 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 posição da quarta correspondência.

Este é um argumento opcional. O padrão é 1 se não for especificado. Você pode especificar um valor negativo para procurar correspondências da direita para a esquerda.

Exemplos de funções
Exemplo Resultado
IndexRegEx('abc123','[a-z][0-9]+') Retorna 3 (a posição inicial da primeira correspondência).
IndexRegEx('abc123','[a-z][0-9]+',2) Retorna 0 (a regex não tem uma segunda correspondência).
IndexRegEx('ABC123','[a-z][0-9]+') Retorna 0, porque IndexRegEx() diferencia maiúsculas de minúsculas.
IndexRegExI('ABC123','[a-z][0-9]+') Retorna 3. A variante da função que não diferencia maiúsculas de minúsculas, IndexRegExI(), é usada.

Quando usar

Os casos de uso dessa função incluem:

  • Identificar onde padrões de texto específicos ocorrem em corpos maiores de texto. Por exemplo, você pode querer saber onde um padrão de endereço de e-mail é usado em uma série de mensagens de e-mail longas.

  • IndexRegEx() é particularmente útil para o processamento avançado de dados e é comumente usado na primeira etapa de uma transformação mais longa e complexa. Em geral, é mais fácil resolver problemas com outras funções regex, como ExtractRegEx(), MatchRegEx() e CountRegEx(), mas pode haver ocasiões em que IndexRegEx() ofereça soluções que essas funções não podem oferecer.

Exemplo 1 – script de carregamento para identificar livros por ISBN

Exemplo 2 – expressão de gráfico para identificar contatos com números de telefone secundários

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!