A função REGEXTEST permite-lhe marcar se qualquer parte do texto fornecido corresponde a uma expressão regular ("regex"). Devolverá VERDADEIRO se existir uma correspondência e FALSO se não existir.
Sintaxe
A função REGEXTEST determina se qualquer parte do texto corresponde ao padrão.
A sintaxe da função REGEXTEST é:
REGEXTEST(texto; padrão; [case_sensitivity])
| Argumento | Descrição |
|---|---|
|
texto (obrigatório) |
O texto ou a referência a uma célula que contém o texto com o qual pretende corresponder. |
|
padrão (obrigatório) |
A expressão regular ("regex") que descreve o padrão de texto que pretende corresponder. |
| case_sensitivity | Determina se a correspondência é sensível às maiúsculas e minúsculas. Por predefinição, a correspondência é sensível às maiúsculas e minúsculas. Insira uma das seguintes opções: 0: Sensível a maiúsculas e 1: Não sensível a maiúsculas |
Observação
Ao escrever padrões regex, os símbolos denominados "tokens" podem ser utilizados que correspondem a uma variedade de carateres. Estes são alguns tokens simples para referência:
- "[0-9]": qualquer dígito numérico
- "[a-z]": um caráter no intervalo de a a z
- ".": qualquer caráter
- "a": o caráter "a"
- "a*": zero ou mais "a"
- "a+": um ou mais "a"
- Todas as expressões regulares para esta função, bem como REGEXEXTRACT e REGEXREPLACE , utilizam o "sabor" PCRE2 do regex.
- REGEXEXTRACT devolve sempre valores de texto. Pode converter estes resultados novamente num número com a função VALOR.
Exemplos
Copie os dados de exemplo e cole-os na célula A1 de uma nova planilha do Excel. Se precisar, você poderá ajustar as larguras das colunas para ver todos os dados.
Exemplo 1
Verificar vários aspetos da cadeia "alfalfa"
| Dados | |
|---|---|
| alfalfa | |
| Fórmulas | Perguntas |
| =REGEXTEST(A2;"a") | Contém a letra "a"? |
| =REGEXTEST(A2,"[a-z]") | Contém letras minúsculas? |
| =REGEXTEST(A2,"[A-Z]") | Contém letras maiúsculas? |
| =REGEXTEST(A2,"[aeiou]") | Contém vogais? |
| =REGEXTEST(A2,"[0-9]") | Contém dígitos numéricos? |
A ilustração a seguir mostra os resultados.
Exemplo 2
Verifique se os números de telefone têm o formato específico "(###) ##-####", utilizando o padrão:
"^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$"
Observação
A barra invertida "\" é utilizada para 'escape' parênteses "()" e outros carateres. Neste padrão, "\(" é interpretado como "(" e "\)" é interpretado como ")"
| Dados |
|---|
| (378) 555-4195 |
| +1(878) 555-8622 |
| Fórmulas |
| =REGEXTEST(A2,"^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$") |
| =REGEXTEST(A2,"^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$") |
A ilustração seguinte mostra o resultado.
![Utilizar REGEXTEST para marcar se os números de telefone estão numa sintaxe específica, com o padrão ^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$](../media/regextest-example-2.png)