Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Substituir

Substitui o texto passado com base em uma determinada condiçãoPesquisa uma sequência de caracteres em um texto e substitui essa sequência por uma nova.

Parâmetros

NomeTipoDoc
Parâmetro 1TextoTexto original
Parâmetro 2TextoCondição para procurar o texto Conteúdo a ser substituídopesquisado
Parâmetro 3TextoNovo textoConteúdo que será substituído. 

Retorno

Retorna o texto após substituição.

Compatibilidade

Servidor

Exemplo

A função abaixo recebe na variável "texto" o bloco Substituir com o parâmetro Texto original recebendo o texto a ser substituído, no parâmetro Texto a ser substituído a condição para procurar no texto e no último parâmetro o Novo texto. Por fim, imprime a variável "texto" no console do depurador. 


Figura 1 - Substituindo o texto

Sobre o bloco

O método percorre toda a string, caso a sequência de caracteres que atendem a condição não seja encontrada, o texto permanece inalterado; caso seja encontrada, uma nova string com a substituição é retornada.

Informações
titleSaiba mais
Veja também os blocos Substituir todos e Substituir a primeira ocorrência.