Substituir

Substitui o texto com base em duas condições: o texto ou expressão RegEx e a tipo (flag).

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 3TextoAdiciona um comportamento na expressão regular
Parâmetro 4TextoNovo texto

Compatibilidade

 Cliente

Retorno

Retorna o texto após substituição.

Exemplo

A função abaixo (Figura 1) recebe na variável "texto" o bloco Substituir com seus parâmetros sendo alimentados da seguinte forma:

  • Texto original: recebe o texto que será alterado;
  • Texto ou RegEx a ser substituído: contém a expressão regular flor? para procurar as ocorrências que comecem com a palavra "flor" mas que não importa como terminem;
  • Tipo usado no regex: possui a flag g, ou seja, a condição para procurar todas as ocorrências;
  • Novo texto: o texto que será substituído nas ocorrências do original.

Note que apesar de procurar todas as ocorrências que comecem com a palavra sugerida, ele substitui apenas a palavra flor por 22. Por fim, imprime a variável "texto" no console do navegador (Figura 2).


Figura 1 - Bloco Substituir 


Figura 2 - Resultado no console

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. 

Saiba mais

Expressão regular ou Regex

Documentação: RegExp

Sobre flags

Flag indica os sinalizadores que podem ser adicionados, veja os valores abaixo:

  • "-" - Procura apenas a primeira ocorrência;
  • "g" - Procura por todas as correspondências;
  • "i" - Procura apenas a primeira ocorrência sem fazer distinção entre maiúsculas e minúsculas;
  • "m" - Modo multilinha - Procura a primeira ocorrência em todas a linhas, caso o texto tenha mais de uma linha;
  • "gi" - Combina o modo global e o indiferente entre maiúsculas e minúsculas;
  • "gim" - Combina o modo global, o indiferente entre maiúsculas e minúsculas e o modo multilinha;
  • "gm" - Combina o modo global e o modo multilinha.
  • Sem rótulos