Busca uma sequência de caracteres em um texto e a substitui por outra definida.


Figura 1 - Bloco Substituir


Se a sequência de caracteres que atende à condição não for encontrada, o texto permanecerá inalterado; caso contrário, será retornada uma nova string com a substituição realizada. Para mais detalhes sobre outros blocos de substituição, consulte a documentação dos blocos Substituir todos e Substituir a primeira ocorrência.

Compatibilidade

  • Bloco servidor: cronapi.text.Operations.replace()

Retorno

Retorna o texto após a substituição dos caracteres informados.

Parâmetros

Texto original

Texto inicial no qual uma sequência de caracteres será alterada.

  • Posição: 1
  • Inglês: Original text
  • Tipo: Texto / String

  • Exemplo: "Cronxpp"

Texto a ser substituído

Sequência de caracteres a ser alterada.

  • Posição: 2
  • Inglês: Text to be replaced
  • Tipo: Texto / String

  • Exemplo: "x"

Novo texto

Nova sequência de caracteres para substituição.

  • Posição: 3
  • Inglês: New text
  • Tipo: Texto / String

  • Exemplo: "a"

Exemplo

A imagem a seguir exibe um exemplo de uso do bloco Substituir. Por meio do bloco, o caractere "x" no texto fornecido é substituído pelo caractere "o". O resultado da substituição é então impresso no console do depurador.


Figura 2 - Exemplo de uso do bloco Substituir

Nesta página