Substituir
Substitui o texto com base em duas condições: o texto ou expressão RegEx e a tipo (flag).
Parâmetros
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | Texto | Texto original |
| Parâmetro 2 | Texto | Condição para procurar o texto a ser substituído, podendo ser texto ou RegEx |
| Parâmetro 3 | Texto | Adiciona um comportamento na expressão regular |
| Parâmetro 4 | Texto | Novo 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 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 flor? para procurar as ocorrências que comecem com a palavra flor mas que não importa como terminem, o parâmetro Tipo usado no regex com a flag g, ou seja, a condição para procurar todas as ocorrências e no último parâmetro o Novo texto. 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.
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.