Substituir

A função Replace usa expressões regulares Java para substituir uma subsequência de uma sequência especificada.

Nota: Para substituir um caractere de barra invertida (\) em uma cadeia, é necessário que ocorra duas vezes o escape do caractere na expressão, resultando em uma cadeia com quatro caracteres de barra invertida (\\\\). Por exemplo, para substituir a subcadeia first\second em uma cadeia, é necessário especificá-la como first\\\\second.

Sintaxe

A função Replace possui a seguinte sintaxe:

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

Parâmetros

A função Replace possui os seguintes parâmetros.

Tabela 1. Parâmetros da Função Replace
Parâmetro	Formato	Descrição
`Expression`	Cadeia	Cadeia que contém a subcadeia a ser substituída.
`Pattern`	Cadeia	A expressão regular que corresponde à subsequência a ser substituída.
`Substitution`	Cadeia	Cadeia a ser substituída para a subcadeia.
`MaxNum`	Integer	Número máximo de substituições a serem executadas.

Valor de Retorno

A cadeia resultante.

Exemplo 1

O exemplo a seguir mostra como substituir uma subcadeia em uma cadeia.

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

Este exemplo imprime a seguinte mensagem no log de política:

Parser Log: New Jersey

Exemplo 2

O exemplo a seguir mostra como substituir o espaço em branco em uma sequência.

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

Este exemplo imprime a seguinte mensagem no log de política:

Parser Log: New_York_City

Exemplo 3

O exemplo a seguir mostra como substituir todos os dígitos em uma sequência.

MyString = "2 hours and 3 days";
Pattern = "[0-9]";
Substitution = "six";
MyReplace = Replace(MyString, Pattern, Substitution);
Log(MyReplace);

Este exemplo imprime a seguinte mensagem no log de política:

Parser Log: six hours and six days

Exemplo 4

O exemplo a seguir mostra como substituir um caractere especial em uma sequência, escapando o padrão de expressão regular.

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

Este exemplo imprime a seguinte mensagem no log de política:

Parser log: SELECT ID FROM TABLE