Regex: Guia de Referencia de Expressoes Regulares

O que sao expressoes regulares

Expressoes regulares (regex ou regexp) sao sequencias de caracteres que definem um padrao de busca em texto. Elas sao usadas para encontrar, validar, extrair e substituir strings em praticamente todas as linguagens de programacao e editores de texto.

Se voce ja precisou validar um email, extrair numeros de um texto, formatar um CPF ou buscar todas as URLs em uma pagina, regex e a ferramenta certa. A sintaxe pode parecer intimidadora no inicio, mas os conceitos fundamentais sao poucos e, uma vez dominados, abrem um mundo de possibilidades.

Para testar suas expressoes em tempo real, use nosso Testador de Regex.

Metacaracteres basicos

Os metacaracteres sao a base de toda expressao regular:

• . — Qualquer caractere (exceto quebra de linha)
• \d — Qualquer digito (0-9)
• \D — Qualquer nao-digito
• \w — Qualquer caractere alfanumerico (letras, digitos, underscore)
• \W — Qualquer nao-alfanumerico
• \s — Qualquer espaco em branco (espaco, tab, quebra de linha)
• \S — Qualquer nao-espaco
• ^ — Inicio da linha
• $ — Fim da linha
• \b — Limite de palavra (word boundary)

Exemplo: \d{3}\.\d{3}\.\d{3}-\d{2} valida o formato de CPF (000.000.000-00).

Quantificadores

Quantificadores definem quantas vezes um elemento pode aparecer:

• * — Zero ou mais vezes
• + — Uma ou mais vezes
• ? — Zero ou uma vez (torna o elemento opcional)
• {n} — Exatamente n vezes
• {n,} — Pelo menos n vezes
• {n,m} — Entre n e m vezes

Por padrao, quantificadores sao gananciosos (greedy) — capturam o maximo possivel. Adicione ? apos o quantificador para torna-lo preguicoso (lazy): .*? captura o minimo possivel.

Exemplo pratico: em <b>negrito</b> e <b>outro</b>, a regex <b>.*</b> captura tudo de uma vez (greedy), enquanto <b>.*?</b> captura cada tag separadamente (lazy).

Grupos, capturas e alternancia

Grupos permitem agrupar partes da expressao e capturar resultados:

• (abc) — Grupo de captura. Captura "abc" e permite referencia posterior.
• (?:abc) — Grupo sem captura. Agrupa sem salvar o resultado.
• (a|b) — Alternancia. Corresponde a "a" ou "b".
• \1, \2 — Referencia ao primeiro, segundo grupo capturado.
• (?=abc) — Lookahead positivo. Verifica se "abc" segue, sem consumi-lo.
• (?!abc) — Lookahead negativo. Verifica se "abc" nao segue.
• (?<=abc) — Lookbehind positivo. Verifica se "abc" precede.

Exemplo: (\w+)@(\w+\.\w+) em "[email protected]" captura "usuario" no grupo 1 e "dominio.com" no grupo 2.

Padroes uteis para o dia a dia

Expressoes regulares prontas para uso comum:

• Email (basico): [a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}
• CPF: \d{3}\.?\d{3}\.?\d{3}-?\d{2} (com ou sem pontuacao)
• CNPJ: \d{2}\.?\d{3}\.?\d{3}/?\d{4}-?\d{2}
• Telefone BR: \(?\d{2}\)?\s?\d{4,5}-?\d{4}
• CEP: \d{5}-?\d{3}
• URL: https?://[\w\-]+(\.[\w\-]+)+[/\w\-.?&=%#]*
• IP v4: \b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b
• Data BR: \d{2}/\d{2}/\d{4}
• Hex color: #[0-9a-fA-F]{3,8}

Importante: essas expressoes cobrem os formatos mais comuns, mas para validacao rigorosa em producao, combine regex com verificacao logica (digitos verificadores de CPF/CNPJ, por exemplo).

Dicas e armadilhas comuns

• Escape caracteres especiais. Os caracteres . * + ? ^ $ { } [ ] ( ) | \ tem significado especial. Para busca-los literalmente, escape com \.
• Use flags. i para case insensitive, g para busca global (todas as ocorrencias), m para multilinha (^ e $ correspondem ao inicio/fim de cada linha).
• Cuidado com backtracking. Expressoes como (a+)+b podem causar backtracking catastrofico em strings longas sem "b". Isso pode travar seu programa.
• Teste sempre. Regex e facil de escrever e dificil de acertar. Teste com multiplos exemplos, incluindo casos limites. Nosso Testador de Regex mostra os matches em tempo real enquanto voce digita.
• Comente expressoes complexas. Na maioria das linguagens, voce pode usar o modo verbose (x flag) para adicionar espacos e comentarios na regex, tornando-a legivel.

Para praticar e validar suas expressoes, acesse nosso Testador de Regex — com destaque de matches em tempo real e explicacao dos resultados.