Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Substituir a primeira ocorrência

Substitui apenas a primeira ocorrência que encontrar.

Parâmetros

NomeTipoDoc
Parâmetro 1TextoTexto original
Parâmetro 2TextoTexto ou RegEx a ser substituído
Parâmetro 3TextoNovo texto

Retorno

Retorna

Retorna um texto (string)

o texto após substituição.

Nota
titleObservaçã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. 


Image Added

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. 

Informações
titleSaiba mais

Expressão regular ou Regex

Documentação: RegExp