Replace

La función Replace utiliza expresiones regulares Java para sustituir una subserie de una serie especificada.

Nota: Para sustituir un carácter de barra invertida (\) de una serie, debe colocar caracteres de escape dos veces en la expresión, lo que dará como resultado una serie con cuatro caracteres de barra invertida (\\\\). Por ejemplo, para sustituir la subserie first\second de una serie, debe especificarla como first\\\\second.

Sintaxis

La función Replace tiene la sintaxis siguiente:

String = Replace(Expression,
Pattern, Substitution, MaxNum)

Parámetros

La función Replace tiene los siguientes parámetros:

Tabla 1. Parámetros de la función Replace
Parámetro	Formato	Descripción
`Expression`	Serie	Serie que contiene la subserie que se ha de sustituir.
`Pattern`	Serie	Expresión regular que coincide con la subserie que se ha de sustituir.
`Substitution`	Serie	Serie que ha de sustituir a la subserie.
`MaxNum`	Entero	Número máximo de sustituciones que se han de realizar.

Valor de retorno

La serie resultante.

Ejemplo 1

El ejemplo siguiente muestra cómo se sustituye una subserie de una serie.

MyString = "New York";
Pattern = "York";
Substitution = "Jersey";
MyReplace = Replace(MyString, Pattern, Substitution, 1);
Log(MyReplace);

Este ejemplo anota el mensaje siguiente en el registro de políticas:

Parser Log: New Jersey

Ejemplo 2

El ejemplo siguiente muestra cómo se sustituye el espacio en blanco de una serie.

MyString = "New York City";
Pattern = "\\s";
Substitution = "_";
MyReplace = Replace(MyString, Pattern, Substitution);
Log(MyReplace);

Este ejemplo imprime el mensaje siguiente en el registro de políticas:

Parser Log: New_York_City

Ejemplo 3

El ejemplo siguiente muestra cómo se sustituyen todos los dígitos de una serie.

MyString = "2 horas y 3 días";
Pattern = "[0-9]";
Substitution = "seis";
MyReplace = Replace(MyString, Pattern, Substitution);
Log(MyReplace);

Este ejemplo imprime el mensaje siguiente en el registro de políticas:

Parser Log: seis horas y seis días

Ejemplo 4

El ejemplo siguiente muestra cómo se sustituye un carácter especial de una serie utilizando caracteres de escape en el patrón de expresión regular.

MyString = "SELECT * FROM TABLE";
Pattern = "\*";
Substitution = "ID";
MyReplace = Replace(MyString, Pattern, Substitution);
Log(MyReplace);

Este ejemplo imprime el mensaje siguiente en el registro de políticas:

Parser log: SELECT ID FROM TABLE