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 | TextoTexto ou | RegEx Condição para procurar o texto a ser substituído, podendo ser texto ou RegEx |
| Parâmetro 3 | Texto | Novo texto |
Retorno
Retorna o texto após substituição
.| title | Observação |
|---|
.
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 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 | ||
|---|---|---|
| ||