ReplaceRegEx - función de script y de gráfico
ReplaceRegEx() devuelve una cadena de caracteres tras sustituir una o varias instancias entre una cadena de entrada y un patrón de expresión regular especificado. El texto que sustituye al texto coincidente se especifica en el argumento to_str. La función opera de izquierda a derecha, pero si especifica un valor de occurrence negativo, las funciones se leerán de derecha a izquierda.
Esta función realiza operaciones regex que distinguen entre mayúsculas y minúsculas. Puede utilizar alternativamente la variante ReplaceRegExI() para realizar operaciones regex sin distinguir mayúsculas de minúsculas.
Sintaxis:
ReplaceRegEx (text, regex, to_str [, occurrence])
Tipo de datos que devuelve: cadena de texto
Argumento | Descripción |
---|---|
text | El texto de la cadena de entrada que desea sustituir, total o parcialmente, por el nuevo texto de to_str. |
regex | La expresión regular que define cuándo reemplazar el texto. Se sustituyen las coincidencias entre este argumento y el argumento text. |
to_str | El nuevo texto que desea utilizar para sustituir el contenido existente de text. |
occurrence |
El número de la coincidencia (entre el texto de entrada y la expresión regular) que sustituir por el nuevo texto. Se trata de un argumento opcional. El valor por defecto es 0 si se omite. Cuando se utiliza un valor 0, o si se omite el argumento, todas las coincidencias entre text y regex se sustituyen por to_str. Puede especificar un valor negativo para occurrence si desea identificar las coincidencias de derecha a izquierda. |
Ejemplo | Resultado |
---|---|
ReplaceRegEx('abc123','[0-9]','x') | Devuelve abcxxx. En este ejemplo, todo el texto de la cadena de entrada que coincida con el patrón regex se sustituye por el nuevo texto. |
ReplaceRegEx('abc123','[0-9]','x',1) | Devuelve abcx23. Solo se sustituye la primera instancia de una coincidencia entre la cadena de entrada y el patrón regex. |
ReplaceRegEx('abc123','[0-9]','x',4) | Devuelve abc123. Solo hay tres coincidencias posibles entre la cadena de entrada y el patrón regex, por lo que no se realiza ninguna modificación. |
ReplaceRegEx('ABC123','[a-c]','5') | Devuelve ABC123. No se realiza ninguna modificación porque ReplaceRegEx() distingue entre mayúsculas y minúsculas, y no se utiliza la variante que no distingue entre mayúsculas y minúsculas. |
ReplaceRegExI('ABC123','[a-c]','5') | Devuelve 555123. Se utiliza la variante de la función que no distingue entre mayúsculas y minúsculas, ReplaceRegExI(). |
Cuándo se utiliza
Puede utilizar ReplaceRegEx() para modificar el texto y cumplir las normas de formato y conformidad, especialmente cuando existen patrones complejos en los datos. Por ejemplo, puede reformatear las cadenas de números de teléfono para que solo incluyan valores numéricos.
Si es necesario, también puede utilizar esta función para enmascarar información sensible, como la información de identificación personal (IIP), para que no se muestre a los usuarios que analicen su app.