A função REGEXTEST permite verificar 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 um dos seguintes: 0: Sensível ao caso 1: Caso insensível |
Observações: 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ê pode ajustar as larguras da coluna para ver todos os dados.
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.
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.
![Usando REGEXTEST para verificar 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}$"](https://cxcs.microsoft.net/static/public/office/pt-br/591ec6a5-2c5a-42e6-b765-b09de6f9340c/7e57526d1c745569cdaa3cd17b379e384c1c9b6d.png)
