Saltar al contenido principal Saltar al contenido complementario

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

Argumentos
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.

Ejemplos de funciones
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.

Ejemplo 1: script de carga para actualizar las direcciones de correo electrónico de los empleados

Ejemplo 2: script de carga para dar formato a códigos ISBN

Ejemplo 3: expresión de gráfico para actualizar direcciones de correo electrónico secundarias

¿Esta página le ha sido útil?

No dude en indicarnos en qué podemos mejorar si encuentra algún problema en esta página o su contenido, como, por ejemplo, errores tipográficos, pasos que falta o errores técnicos.