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

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

MatchRegEx() compara a string de entrada com um ou mais padrões de expressão regular especificados e retorna a localização numérica dos padrões de expressão regular correspondentes. Se nenhuma correspondência for encontrada, a função retornará 0. Essa função procura apenas correspondências exatas.

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

Sintaxe:  

MatchRegEx (text, regex1 [ , regex2,...regexN])

Tipo de dados de retorno: inteiro

Argumentos
Argumento Descrição
text O texto da string de entrada ao qual você deseja corresponder uma ou mais expressões regulares.
regex A expressão regular a ser tentada para corresponder à string de entrada. Você pode especificar mais de uma expressão regular em uma única expressão, separadas como argumentos subsequentes.
Exemplos de funções
Exemplo Resultado
MatchRegEx('abc123','[a-z]','[0-9]','[a-z]+[0-9]+','.+') Retorna 3. O terceiro padrão regex é o primeiro a corresponder aos dados.
MatchRegEx('ABC','[abc]+','[123]') Retorna 0, porque MatchRegEx() diferencia maiúsculas de minúsculas.
MatchRegExI('ABC','[abc]+','[123]') Retorna 1. A variante da função que não diferencia maiúsculas de minúsculas, MatchRegExI(), é usada.

Quando usar

Os casos de uso dessa função incluem:

  • Validação de texto para atender aos padrões de formatação e conformidade e identificar erros nos dados.

  • Identificação de diferenças na forma como o texto é formatado. Por exemplo, você pode identificar quantos números de telefone usam o formato A, o formato B e assim por diante.

Exemplo 1 – script de carregamento para analisar formatos de números de telefone

Exemplo 2 – expressão de gráfico para identificar o formato ISBN

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!