Como testar uma expressão regular e analisar as correspondências

O que pode testar

O Regex Tester permite verificar se um padrão de expressão regular encontra correspondências num texto de teste e consultar informação sobre cada resultado. É útil para validar padrões antes de os integrar numa pesquisa, filtro ou rotina de tratamento de texto.

Introduza o padrão no campo correspondente e forneça um texto que contenha, ou possa conter, o tipo de conteúdo que pretende localizar. Pode também indicar modos de correspondência através das flags reconhecidas. O resultado não se limita a dizer se houve correspondência: numa avaliação bem-sucedida, apresenta o total de correspondências e detalhes associados a cada uma.

Como testar uma expressão regular

1. No campo do padrão, escreva a expressão regular que pretende testar. Não o deixe vazio: sem um padrão, a avaliação falha antes de qualquer correspondência ser procurada.

2. No campo do texto de teste, cole ou escreva o conteúdo a analisar. Quando existe um padrão, este campo também não pode ficar vazio.

3. Se necessário, indique flags no campo próprio. São reconhecidas i para ignorar maiúsculas e minúsculas, m para correspondência em várias linhas, s para permitir que o ponto abranja mudanças de linha, x para o modo de expressão legível, u para Unicode e a para ASCII. Caracteres de flag fora deste conjunto não ativam um modo de correspondência.

4. Execute a avaliação. O padrão tem de ser compilável como expressão regular; se for inválido, a operação falha em vez de devolver detalhes de correspondência.

5. Leia o resultado devolvido. Numa avaliação válida, confirme o total de correspondências e, para cada uma, consulte as posições inicial e final, o texto encontrado e os grupos capturados. Os grupos podem ser numerados ou ter um nome.

Como interpretar o resultado

Um resultado válido indica que o padrão foi avaliado com sucesso. O total informa quantas correspondências foram encontradas; esse total pode ser zero, sem que isso signifique que a avaliação falhou. Quando existem correspondências, as posições ajudam a localizar cada ocorrência no texto, o texto encontrado mostra o trecho correspondente e os grupos revelam as partes capturadas pelo padrão.

Se o resultado indicar falha, reveja primeiro se o padrão e o texto foram preenchidos. Depois, verifique a sintaxe da expressão regular e confirme se as flags usadas pertencem ao conjunto reconhecido. Uma flag não reconhecida não produz necessariamente uma mensagem de correspondência diferente: simplesmente não ativa o modo pretendido.

Exemplo prático

Pretende localizar o número de uma encomenda e consultar também o valor capturado pelo grupo nomeado.

Introduza o padrão (?<numero>\d+), escreva Encomenda 482 pronta no texto de teste e execute a avaliação sem adicionar flags.

O resultado válido apresenta o total de correspondências e, para cada uma, as posições inicial e final, o texto encontrado e o grupo nomeado numero, quando este for capturado.

Limitações

• Apenas as flags i, m, s, x, u e a alteram o modo de correspondência; outros caracteres não o ativam.

Erros comuns

• Usar uma flag fora de i, m, s, x, u ou a não ativa o modo esperado. Remova esse carácter ou substitua-o pela flag reconhecida correspondente antes de repetir a avaliação.

Perguntas frequentes

O que acontece quando não existe nenhuma correspondência?

Desde que o padrão seja válido e o texto de teste não esteja vazio, a avaliação é bem-sucedida e pode indicar zero correspondências, continuando a apresentar o total da avaliação.

Todas as flags são reconhecidas?

Não. Apenas i, m, s, x, u e a ativam modos de correspondência; outros caracteres de flag são ignorados.

O que acontece com um padrão inválido?

A avaliação falha e não devolve detalhes de correspondência. Reveja a sintaxe do padrão e tente novamente com uma expressão regular compilável.