Saltar al contenido principal Saltar al contenido complementario

ReplaceRegExGroup - función de script y de gráfico

ReplaceRegExGroup() devuelve una cadena de caracteres tras sustituir una o varias instancias entre una cadena de entrada y el patrón de expresión regular compuesto que se especifique. 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 ReplaceRegExGroupI() para realizar operaciones regex sin distinguir mayúsculas de minúsculas.

Sintaxis:  

ReplaceRegExGroup (text, regex, to_str, group [, 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.
group

El número del grupo, en el caso de una expresión regular compuesta.

Si la expresión regular solo contiene un grupo, utilice en su lugar la función ReplaceRegEx(). Como alternativa, utilice ReplaceRegExGroup() con un valor de group0.

Puede especificar un valor negativo en group para buscar grupos de derecha a izquierda.

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 predeterminado 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
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',0) Devuelve abx (reemplazar coincidencia completa).
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',1) Devuelve abx123 (solo sustituye al primer grupo de la coincidencia).
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',2) Devuelve abcx (solo sustituye al segundo grupo de la coincidencia).
ReplaceRegExGroup('abc123abc123','([a-z])([0-9]+)','x',1,2) Devuelve abc123abx123. Hay dos coincidencias entre el primer grupo del texto de entrada y el patrón regex. Sin embargo, solo se sustituye la segunda instancia.
ReplaceRegExGroup('ABC123ABC123','([a-z])([0-9]+)','x',1) Devuelve ABC123ABC123. En otras palabras, no se sustituye ningún texto. Esto se debe a que la función distingue entre mayúsculas y minúsculas, y no se utiliza la variante de la función que no distingue entre mayúsculas y minúsculas.
ReplaceRegExGroupI('ABC123ABC123','([a-z])([0-9]+)','x',1) Devuelve ABx123ABx123. En este ejemplo, la sustitución del texto se produce porque se utiliza la variante de la función que no distingue entre mayúsculas y minúsculas, ReplaceRegExGroupI().

Cuándo se utiliza

Puede utilizar ReplaceRegExGroup() para modificar el texto y cumplir las normas de formato y conformidad, especialmente cuando necesite identificar patrones complejos en los datos. El argumento adicional group de esta función le permite actualizar solo determinadas partes de un patrón de texto más amplio. Por ejemplo, puede actualizar partes específicas de una URL.

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 el dominio en las direcciones URL

Ejemplo 2: expresión de gráfico para actualizar el protocolo en las URL

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