Match regex

Match regex ( padrao ; umaCadeia ; posiçao {; pos_encont ; compr_encont}{; *} ) -> Resultado 
Match regex ( padrao ; umaCadeia ) -> Resultado

Parâmetro	Tipo		Descrição
padrao	Text	→	Expressão regular
umaCadeia	Text	→	Cadeia na qual será realizada a pesquisa
posiçao	Integer	→	Posição em umaCadeia onde começa a pesquisa
pos_encont	Integer array, Integer	←	Posição da ocorrência
compr_encont	Integer array, Integer	←	Comprimento da ocorrência
*	Operador	→	Se passado, a função pesquisa apenas na posição indicada
Resultado	Boolean	←	True=pesquisa encontrou uma ocorrência, se não, False
Match regex ( padrao ; umaCadeia ) -> Resultado
Parâmetro	Tipo	Descrição
padrao	Text	→	Expressão regular (igualdade completa)
umaCadeia	Text	→	Cadeia na qual será realizada a pesquisa
Resultado	Boolean	←	True = pesquisa encontrou uma ocorrência, se não, False

Descrição

O comando Match regex permite provar a conformidade de uma cadeia de caracteres relativo a um conjunto de regras sintetizadas por meio de um metalinguagem chamado “expressão regular” ou “expressão racional.” A abreviação regex é comumente empregada para indicar estes tipos de notações.

Passe em padrao a expressão regular a procurar. Consiste em um conjunto de caracteres utilizado para descrever uma cadeia de caracteres, utilizando caracteres especiais.

Passe em umaCadeia a cadeia na qual buscar a expressão regular.

Passe em início, a posição em umaCadeia onde deve começar a pesquisa.

Se pos_encont. e compr_encont são variáveis, o comando devolve a posição e o comprimento da ocorrência nestas variáveis. Se passa arrays, o comando devolve a posição e o comprimento da ocorrência no elemento zero dos arrays e as posições e comprimentos dos grupos capturados pela expressão regular nos elementos seguintes.

O parâmetro opcional * indica, quando for passado, que a pesquisa deve ser realizada na posição especificada por início e para de pesquisar em caso de falhas.

O comando devolve True se a pesquisa encontrar uma ocorrência.

Para maior informação sobre regex, consulte o seguinte endereço:
http://pt.wikipedia.org/wiki/Express%C3%A3o_regular

Para maior informação sobre a sintaxe das expressões regulares passadas no parâmetro padrao, consulte o seguinte endereço:
https://unicode-org.github.io/icu/userguide/strings/regexp.html#regular-expressions

Exemplo 1

Pesquisa de igualdade completa:

 vencont:=Match regex(motivo;meutexto)
 QUERY BY FORMULA([Empregados];Match regex(".*vargas.*";[Empregados]sobrenome))

Exemplo 2

Pesquisa no texto por posição:

 vencont:=Match regex(motivo;meutexto;inicio;pos_encont;compr_encont)

Exemplo para mostrar todas as etiquetas de $1:

 inicio:=1
 Repeat
    vencont:=Match regex("<.*>";$1;inicio;pos_encont;compr_encont)
    If(vencont)
       ALERT(Substring($1;pos_encont;compr_encont))
       inicio:=pos_encont+compr_encont
    End if
 Until(Not(vencont))

Exemplo 3

Pesquisa compatível com “grupos capturados” através de parênteses. ( ) são utilizadas para especificar grupos nos regex:
vencont:=Match regex(motivo;meutexto; inicio; pos_encont; compr_encont_array)

 ARRAY LONGINT(pos_encont_array;0)
 ARRAY LONGINT(compr_encont_array;0)
 vencont:=Match regex("(.*)stuff(.*)";$1;1;pos_encont_array;compr_encont_array)
 If(vencont)
    $grupo1:=Substring($1;pos_encont_array{1};compr_encont_array{1})
    $grupo2:=Substring($1;pos_encont_array{2};compr_encont_array{2})
 End if

Exemplo 4

Pesquisa limitando a comparação do motivo a posição indicada:
Adicionar una estrela ao final de uma das duas sintaxes anteriores.

 vencont:=Match regex("a.b";"---a-b---";1;$pos_encont;$compr_encont )
  //devolve True
 vencont:=Match regex("a.b";"---a-b---";1;$pos_encont;$compr_encont ;*)
  //devolve False
 vencont:=Match regex("a.b";"---a-b---";4;$pos_encont;$compr_encont ;*)
  //devolve True

Nota: as posições e comprimentos retornados são significativos apenas em modo Unicode ou se o texto manipulado for de tipo ASCII 7-bits.

Gestão de erros

Em caso de erro, o comando gera um erro que pode interceptar através de um método instalado pelo comando ON ERR CALL.