A função REGEXTEST permite-lhe verificar 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 (necessário) |
O texto ou a referência a uma célula que contém o texto com o qual pretende corresponder. |
|
padrão (necessá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. Introduza uma das seguintes opções: 0: Sensível a maiúsculas e 1: Não sensível a maiúsculas |
Notas: 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 folha de cálculo do Excel. Se quiser, pode ajustar as larguras das colunas para ver todos os dados.
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 seguinte mostra os resultados.
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 '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 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}$"](https://cxcs.microsoft.net/static/public/office/pt-pt/591ec6a5-2c5a-42e6-b765-b09de6f9340c/c35c483b932d4214accf33ef6ca01cac0bf87873.png)
