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 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.
| Informaçõ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.