A função REGEX.TESTAR 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 REGEX.TESTAR determina se qualquer parte do texto corresponde ao padrão.
A sintaxe da função REGEX.TESTAR é:
REGEX.TESTAR(texto; padrão; [case_sensitivity])
|
Argumento |
Descrição |
|---|---|
|
text (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ções: 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 REGEX.EXTRAIR e REGEX.SUBSTITUIR utilizam o "sabor" PCRE2 do regex.
-
REGEX.EXTRAIR sempre devolver 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.
Verificar vários aspetos da cadeia "alfalfa"
|
Dados |
|
|
alfalfa |
|
|
Fórmulas |
Perguntas |
|
=REGEX.TESTAR(A2;"a") |
Contém a letra "a"? |
|
=REGEX.TESTAR(A2;"[a-z]") |
Contém letras minúsculas? |
|
=REGEX.TESTAR(A2;"[A-Z]") |
Contém letras maiúsculas? |
|
=REGEX.TESTAR(A2;"[aeiou]") |
Contém vogais? |
|
=REGEX.TESTAR(A2;[0-9]") |
Contém dígitos numéricos? |
A ilustração a seguir 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}$"
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 |
|
=REGEX.TESTAR(A2,"^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$") |
|
=REGEX.TESTAR(A2,"^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$") |
A ilustração seguinte mostra o resultado.
![Usar REGEX.TESTAR para marcar se os números de telefone estão em uma sintaxe específica, com o padrão "^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$"](/images/pt-br/591ec6a5-2c5a-42e6-b765-b09de6f9340c?format=avif&w=800)
