Pular para o conteúdo principal

Função REGEXTEST

A função REGEX.TESTAR é uma das funções de texto e dados. É usada para verificar se alguma parte do texto fornecido corresponde a um padrão de expressão regular, retornando VERDADEIRO ou FALSO.

Sintaxe​

REGEX.TESTAR(texto, padrão, [sensibilidade_ao_caso])

A função REGEX.TESTAR possui os seguintes argumentos:

ArgumentoDescrição
textoA string de texto ou referência a uma célula contendo o texto que você deseja testar contra o padrão.
padrãoA expressão regular ("regex") que descreve o padrão de texto que você deseja corresponder.
sensibilidade_ao_casoDetermina se a correspondência é sensível a maiúsculas e minúsculas. É um argumento opcional. Se omitido, a correspondência é sensível a maiúsculas e minúsculas (0). Insira 0 para correspondência sensível a maiúsculas e minúsculas ou 1 para correspondência insensível a maiúsculas e minúsculas.

Notas​

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
  • [A-Z]: um caractere no intervalo de A a Z
  • .: qualquer caractere único
  • *: zero ou mais do caractere anterior
  • +: um ou mais do caractere anterior
  • ^: início da string
  • $: final da string
  • \: caractere de escape (por exemplo, \( corresponde a um parêntese literal)
  • {n}: exatamente n ocorrências do caractere anterior

A função retorna VERDADEIRO se o padrão corresponder a qualquer parte do texto, e FALSO se nenhuma correspondência for encontrada.

Como aplicar a função REGEX.TESTAR.

Exemplos​

A figura abaixo exibe o resultado retornado pela função REGEX.TESTAR.

Função REGEXTEST