Replace

Substitui uma cadeia de caracteres no texto especificado por textoDeSubstituição.

Formato 

Replace ( texto ; início ; númeroDeCaracteres ; textoDeSubstituição )

Parâmetros 

texto - qualquer expressão de texto ou campo de texto

início - qualquer campo ou expressão numérica que contém um número que representa a posição inicial em texto

númeroDeCaracteres - qualquer campo ou expressão numérica que contém um número que representa o número de caracteres para remover do texto

textoDeSubstituição - qualquer campo ou expressão de texto que contém o texto para substituir na cadeia original

Tipo de dados retornado 

texto

Originada na versão 

6.0 ou anterior

Descrição 

A substituição de caractere em texto começa na posição de caractere inicial e continua para númerodeCaracteres caracteres. Compare com a função Substitute.

Exemplo 1 

Replace("1234567";5;1;"X") retorna 1234X67.

Replace("1234567";5;1;"XX") retorna 1234XX67.

Replace ( "1234567" ; 5 ; 2 ; "X" ) retorna 1234X7.

Replace ( "1234567" ; 5 ; 0 ; "X" ) retorna 1234X567.

Exemplo 2 

Replace("William";3;4;”NEW TEXT”) retorna WiNEW TEXTm.

Exemplo 3 

Replace(NúmerodeTelefone;1;3;"415") retorna 415-555-9054, quando o campo NúmerodeTelefone contém 408-555-9054.