Substitui apenas a primeira ocorrência encontrada no texto com base em uma sequência de caracteres ou em uma expressão regular (RegEx). Para substituir todas as ocorrências do texto, utilize o bloco Substituir todos.

Figura 1 - Bloco Substituir a primeira ocorrência

Compatibilidade

• Bloco servidor: cronapi.text.Operations.replaceFirst()

Retorno

Retorna o texto após a substituição solicitada.

Parâmetros

Texto original

Este parâmetro recebe o texto que será modificado.

• Posição: 1
• Inglês: Original text
  
• Tipo: Texto / String

• Exemplo: "Plataforma que acelera o ciclo de desenvolvimento"

Texto ou RegEx a ser substituído

Condição de busca para localizar o texto que será substituído, podendo ser uma sequência de texto ou uma expressão regular (RegEx).

• Posição: 2
• Inglês: A RegEx or Text
  
• Tipo: Texto / String

• Exemplo: ([aeiou])

Novo texto

Texto que substituirá a primeira ocorrência no texto original.

• Posição: 3
• Inglês: New Text
  
• Tipo: Texto / String

• Exemplo: "#"

Exemplo

Na função abaixo, o bloco Substituir a primeira ocorrência, o parâmetro "Texto ou RegEx a ser substituído" contém a expressão regular ([A-Z]), que identifica as letras maiúsculas no parâmetro "Texto original" e substitui sua primeira ocorrência pelo caractere informado no parâmetro "Novo texto". O resultado de execução será impresso no console do depurador.

Figura 2 - Exemplo de uso do bloco Substituir a primeira ocorrência