Match regex

Match regex ( patron ; laCadena ; inicio {; pos_encont. ; long_encont.}{; *} ) -> Resultado 
Match regex ( patron ; laCadena ) -> Resultado

Parámetro	Tipo		Descripción
patron	Text	→	Expresión regular
laCadena	Text	→	Cadena en la cual se efectúa la búsqueda
inicio	Integer	→	Posición de laCadena donde comenzar la búsqueda
pos_encont.	Array entero largo, Variable entero largo	←	Posición de la ocurrencia
long_encont.	Array entero largo, Variable entero largo	←	Longitud de la ocurrencia
*	Operador	→	Si se pasa: buscar únicamente en la posición indicada
Resultado	Boolean	←	True = la búsqueda ha encontrado una ocurrencia; De lo contrario, False.
Match regex ( patron ; laCadena ) -> Resultado
Parámetro	Tipo	Descripción
patron	Text	→	Expresión regular (igualdad completa)
laCadena	Text	→	Cadena en la cual se efectúa la búsqueda
Resultado	Boolean	←	True= la cadena encuentra una ocurrencia, de lo contrario False

Descripción

El comando Match regex permite probar la conformidad de una cadena de caracteres con respecto a un conjunto de reglas sintetizadas por medio de un metalenguaje llamado “expresión regular” o “expresión racional.” La abreviación regex es comúnmente empleada para indicar esto tipos de notaciones.

Pase en patrón la expresión regular a buscar. Consiste de un conjunto de caracteres utilizado para describir una cadena de caracteres, utilizando caracteres especiales.

Pase en laCadena la cadena en la cual buscar la expresión regular.

Pase en inicio, la posición en laCadena donde debe comenzar la búsqueda.

Si *pos_encont.*y long_encont son variables, el comando devuelve la posición y la longitud de la ocurrencia en estas variables. Si pasa arrays, el comando devuelve la posición y la longitud de la ocurrencia en el elemento cero de los arrays y las posiciones y longitudes de los grupos capturadas por la expresión regular en los elementos siguientes.

El parámetro opcional * indica, cuando se pasa, que la búsqueda debe llevarse a cabo en la posición especificada por inicio sin buscar más allá en caso de falla.

El comando devuelve True si la búsqueda encuentra una ocurrencia.

Para mayor información sobre regex, consulte la siguiente dirección:
http://en.wikipedia.org/wiki/Regular\_expression

Para mayor información sobre la sintaxis de las expresiones regulares pasadas en el parámetro patrón, consulte la siguiente dirección:
https://unicode-org.github.io/icu/userguide/strings/regexp.html#regular-expressions

Ejemplo 1

Búsqueda de igualdad completa (sintaxis simple):

vencontrado:=Match regex(plantilla;mitexto)

 QUERY BY FORMULA([Empleados];Match regex(".*smith.*";[Empleados]nombre))

Ejemplo 2

Búsqueda en el texto por posición:

 vencont:=Match regex(motivo;mitexto;inicio;pos_encont;long_encont)

Ejemplo para mostrar todas las etiquetas de $1:

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

Ejemplo 3

Búsqueda con soporte de “grupos capturados” vía paréntesis. ( ) se utilizan para especificar grupos en los regex:
vencont:=Match regex(motivo;mitexto; inicio; pos_encont; long_encont_array)

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

Ejemplo 4

Búsqueda limitando la comparación del motivo a la posición indicada:
Añadir una estrella al final de una de las dos sintaxis anteriores.

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

Nota: las posiciones y largos devueltos son significativosn sólo en modo Unicode o si el texto manipulado es de tipo ASCII 7-bits.

Gestión de errores

En caso de error, el comando genera un error que puede interceptar vía un método instalado por el comando ON ERR CALL.