A função REGEX.TESTAR permite-lhe verificar se alguma parte do texto fornecido corresponde a uma expressão regular ("regex"). Será devolvido VERDADEIRO se houver uma correspondência e FALSO se não existir.
Sintaxe
A função REGEX.TESTAR determina se qualquer parte do texto corresponde ao padrão.
A sintaxe da função REGEX.TESTE é:
REGEX.TESTE(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 fazer corresponder. |
|
padrão (obrigatório) |
A expressão regular ("regex") que descreve o padrão do 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. Introduza uma dos seguintes opções: 0: Sensível a maiúsculas 1: Não sensível a maiúsculas e minú |
Nota
Ao escrever padrões de regex, símbolos chamados 'tokens' podem ser usados que combinam com uma variedade de caracteres. Estes são alguns tokens simples para referência:
- "[0-9]": qualquer algarismo 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 usam o "sabor" PCRE2 do regex.
- REGEX.EXTRACT sempre retorna valores de texto. Pode converter estes resultados num número com a função VALOR.
Exemplos
Copie os dados de exemplo e copie-os na célula A1 de uma nova folha de cálculo do Excel. Se quiser, pode ajustar as larguras das colunas para ver todos os dados.
Exemplo 1
Verifique vários aspectos da cadeia 'alfafa'
| Dados | |
|---|---|
| alfafa | |
| Fórmulas | Perguntas |
| =REGEX.TESTE(A2,"a") | Contém a letra «a»? |
| =REGEX.TESTE(A2,"[a-z]") | Contém letras minúsculas? |
| =REGEXTEST(A2,"[A-Z]") | Contém letras maiúsculas? |
| =REGEXTEST(A2,"[aeiou]") | Contém vogais? |
| =REGEX.TESTE(A2,"[0-9]") | Contém algum dígito numérico? |
A ilustração seguinte 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}$"
Nota
A barra invertida "\" é utilizada para "escapar" dos parênteses "()" e de alguns 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 REGEX.TESTAR para verificar 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)