Substitui apenas a primeira ocorrência que encontrar.
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
Novo texto
Retorno
Retorna o texto após substituição.
Compatibilidade
Servidor
Exemplo
A função abaixo recebe na variável "texto" o blocoSubstituir a primeira ocorrênciacom o parâmetroTexto originalrecebendo o texto a ser substituído, no parâmetroTexto ou RegEx a ser substituídoconté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 oNovo texto. Apesar de encontrar diversas ocorrências, o bloco se limita a substituir apenas a primeira que foi encontrada. Por fim, imprimea 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.