Função REGEXTEST

Aplica-se a
Excel para Microsoft 365 Excel para Microsoft 365 para Mac

A função REGEXTEST permite que você marcar se qualquer parte do texto fornecido corresponde a uma expressão regular ("regex"). Ele retornará TRUE se houver uma correspondência e FALSE se não houver.

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 que você deseja corresponder.
padrão
(obrigatório)		 A expressão regular ("regex") que descreve o padrão de texto que você deseja corresponder.
case_sensitivity Determina se a correspondência é sensível a casos. Por padrão, a correspondência é sensível a maiúsculas de minúsculas. Insira uma das seguintes opções:
0: Sensível ao caso
1: Caso insensível

Observação

Ao escrever padrões regex, símbolos chamados "tokens" podem ser usados que correspondem a uma variedade de caracteres. Estes são alguns tokens simples para referência:

  • "[0-9]": qualquer dígito numérico
  • "[a-z]": um caractere no intervalo de a a z
  • ".": qualquer caractere
  • "a": o caractere "a"
  • "a*": zero ou mais "a"
  • "a+": um ou mais "a"
  • Todas as expressões regulares para essa função, bem como REGEXEXTRACT e REGEXREPLACE usam o "sabor" PCRE2 de regex.
  • REGEXEXTRACT sempre retorna valores de texto. Você pode converter esses resultados de volta em um número com a função VALUE.

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

Verifique vários aspectos da cadeia de caracteres 'alfalfa'

Dados
Alfafa
Fórmulas Perguntas
=REGEXTEST(A2,"a") Ela contém a letra 'a'?
=REGEXTEST(A2"[a-z]") Ele contém letras minúsculas?
=REGEXTEST(A2"[A-Z]") Ele contém letras maiúsculas?
=REGEXTEST(A2"[aeiou]") Ele contém vogais?
=REGEXTEST(A2"[0-9]") Ele contém algum número de dígitos?

A ilustração a seguir mostra os resultados.

Usando REGEXTEXT para responder a várias perguntas sobre a palavra alfafa

Exemplo 2

Verifique se os números de telefone têm o formato específico "(###) #######", usando o padrão:

"^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$"

Observação

Backslash "\" é usado para 'escapar' parênteses "()" e alguns outros caracteres. Nesse 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 a seguir mostra o resultado.

Usar REGEXTEST 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}$