Substituir a primeira ocorrência
Substitui apenas a primeira ocorrência que encontrar.
Parâmetros
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | Texto | Texto original |
| Parâmetro 2 | Texto | Texto ou RegEx a ser substituído |
| Parâmetro 3 | Texto | Novo texto |
Retorno
Retorna o texto após substituição.
Observação
Caso retorne o texto original, significa que a condição determinada não encontrou ocorrências.
Compatibilidade
Servidor
Exemplo
A função abaixo recebe na variável "texto" o bloco Substituir a primeira ocorrência 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. Apesar de encontrar diversas ocorrências, o bloco se limita a substituir apenas a primeira que foi encontrada. Por fim, imprime a variável "extrair" no console do depurador.
Figura 1 - Substituindo a primeira ocorrência
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.