Como aplicar regras de localizar e substituir texto

Para que serve

Esta ferramenta aplica regras de localizar e substituir ao texto fornecido. É útil quando precisa de corrigir termos, uniformizar grafias ou fazer várias substituições numa única operação, mantendo a ordem definida para as regras.

Como aplicar as regras

1. Introduza o texto que pretende alterar. O campo é opcional; se ficar omitido, é tratado como texto vazio.

2. Prepare uma lista de regras pela ordem em que devem ser executadas. Em cada regra, indique o valor a localizar e o valor de substituição. Uma regra cujo valor de localização esteja vazio ou tenha sido omitido é ignorada e não conta como aplicada.

3. Para uma correspondência literal, deixe o modo de expressão regular desativado. Nesse modo, a correspondência não distingue maiúsculas de minúsculas por predefinição. Se ativar case_sensitive, a distinção passa a ser respeitada.

4. Quando precisar de padrões, ative o modo de expressão regular na regra. A correspondência continua a ignorar maiúsculas e minúsculas por predefinição, salvo se case_sensitive estiver ativo.

5. Envie o texto e a lista de regras para processamento. As regras são executadas pela ordem da lista: uma substituição altera o texto que será analisado pela regra seguinte. Se o texto não estiver vazio, a ausência de regras equivale a uma lista vazia. Nesse caso, não há substituições a aplicar.

6. Reveja o resultado e a informação sobre as regras aplicadas. Se o texto enviado estiver vazio ou for omitido, a operação termina com resultado vazio e zero regras aplicadas, sem processar a lista. Para texto não vazio, o valor de regras deve ser uma lista; um valor não nulo de outro tipo conduz a uma operação malsucedida.

Como interpretar o resultado

Leia o texto final tendo em conta a sequência das alterações. Uma regra posterior pode localizar texto que foi inserido por uma regra anterior, pelo que trocar a ordem das regras pode mudar o resultado.

O número de regras aplicadas não inclui regras com um valor de localização vazio. No modo literal, uma diferença entre maiúsculas e minúsculas só deve impedir a correspondência quando a regra tiver case_sensitive ativo. No modo de expressão regular, confirme também que o padrão descreve o texto que pretende localizar.

Um padrão de expressão regular inválido não torna a operação global malsucedida: o problema é recolhido para essa regra, que não é aplicada, e o processamento prossegue. Por isso, verifique a informação de erro mesmo quando a operação indica sucesso. Se precisar de validar uma substituição específica, teste-a com um texto curto antes de combinar várias regras.

Exemplo prático

Uma pessoa quer uniformizar duas ocorrências de «maçã» e depois trocar o termo intermédio pelo termo final numa única operação.

Envie o texto «A maçã. A MAÇÃ.» com uma primeira regra que substitua «maçã» por «pera» e uma segunda que substitua «pera» por «fruta», mantendo o modo literal.

Depois das duas alterações, o texto terá a forma «A fruta. A fruta.» e serão consideradas duas regras aplicadas.

Limitações

• Uma expressão regular inválida não é aplicada, embora a operação global indique sucesso; texto vazio termina sem processar regras.

Erros comuns

• Causa: enviar regras como texto ou como outro valor que não seja uma lista quando o texto não está vazio. Correção: organize as regras numa lista antes de iniciar a operação.

Perguntas frequentes

Posso aplicar várias substituições na mesma operação?

Sim, desde que o texto não esteja vazio e que regras seja uma lista. Cada regra é executada pela ordem indicada, e uma regra posterior trabalha sobre o texto já alterado.

É possível usar expressões regulares?

Sim. Ative o modo de expressão regular na regra e, se necessário, defina case_sensitive para distinguir maiúsculas de minúsculas. Um padrão inválido é registado como erro dessa regra e o processamento continua.

O que acontece se não introduzir texto ou regras?

Quando o texto é vazio ou foi omitido, a operação termina com resultado vazio e zero regras aplicadas, sem processar as regras. Quando o texto não está vazio e as regras são omitidas ou têm valor nulo, são tratadas como uma lista vazia.