Versões comparadas

Chave

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

Substituir todos

Substitui todas as ocorrências encontradas com base em uma sequência de caracteres ou expressão RegEx.

Parâmetros

NomeTipoDoc
Parâmetro 1TextoTexto original
Parâmetro 2TextoCondição para procurar o texto a ser substituído, podendo ser texto ou RegEx
Parâmetro 3TextoNovo texto

Retorno

Retorna o texto após substituição.

Compatibilidade

Servidor

Exemplo

A função abaixo recebe na variável "texto" o bloco Substituir todos com o parâmetro Texto original recebendo o texto a ser substituído, no parâmetro Texto ou RegEx a ser substituído contém a expressão regular ([A-Z]) para procurar todas as letras que começam com a letra maiúscula e no último parâmetro o Novo texto. Por fim, imprime a variável "texto" no console do depurador.


Figura 1 - Substituindo todas as ocorrências

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.

Sobre RegEx ou expressão regular

É uma forma de identificar, através de expressões regulares, diversos caracteres, sejam eles em cadeia, individuais, palavras ou padrões. 

Informações
titleSaiba mais

Expressão regular ou Regex

Documentação: RegExp