# REGEXP

> Usar expressões regulares para encontrar padrões em strings com SQL no StackQL.

Source: https://stackql.io/pt-br/language-spec/functions/re/regexp

Verifica se a string de origem corresponde ao padrão de expressão regular fornecido.

Veja também:  
[[`SELECT`]](/language-spec/select)

* * * 

## Sintaxe

```sql
SELECT source_string REGEXP pattern_expression AS match_result FROM <multipartIdentifier>;
```

## Argumentos

__*source_string*__  
A string na qual o padrão é procurado.

__*pattern_expression*__  
O padrão de expressão regular a ser comparado com a string de origem.

## Valor(es) retornado(s)
Retorna um valor booleano: `TRUE` se a string de origem corresponder ao padrão de expressão regular; caso contrário, `FALSE`.

* * *

## Exemplos

### Verificar se uma string contém números

Este exemplo verifica se a string 'the year is 2021' contém um ou mais caracteres numéricos:

```sql
SELECT 'the year is 2021' REGEXP '[0-9]+' AS match_result;
```

Esta consulta retorna `TRUE` porque a string contém a substring '2021', que corresponde ao padrão `[0-9]+`, que indica um ou mais dígitos.

### Validar o formato de e-mail

Para verificar se uma string está em um formato de e-mail válido:

```sql
SELECT 'user@example.com' REGEXP '^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$' AS match_result;
```

Esta consulta retorna `TRUE`, o que indica que 'user@example.com' tem o formato de um endereço de e-mail típico e corresponde ao padrão de expressão regular especificado.
