Função FIND

Localiza uma cadeia de caracteres de texto contida em outra cadeia de texto e retorna a posição inicial da cadeia de caracteres de texto que você está buscando em relação à sua posição na cadeia de texto que a contém.

Sintaxe

FIND (find_text, within_text,[ start_num ], [ ignore_case ])

Parâmetros

Name Obrigatório/opcional Tipo de dados Descrição
Texto_procurado
Obrigatório
 String
A cadeia de caracteres de texto a ser localizada.
format
Obrigatório
 String
A cadeia de caracteres que contém o texto a ser localizado.
Núm_inicial
Opcional
 Número
O caractere para início da pesquisa. O primeiro caractere em within_text é 1. Se start_num não for definido, será assumido como 1.
ignore_case
Opcional
 Boolean
Por padrão, a função FIND distingue maiúsculas e minúsculas. Para que a função FIND ignore maiúsculas e minúsculas, defina este argumento como TRUE.

Valor de retorno

Número

Comentários

Se vários valores correspondentes forem localizados, a função FIND retornará a posição inicial do primeiro valor correspondente na cadeia de caracteres. O argumento find_text não considera nenhum caractere curinga.

Se fim_text:

  • Estiver vazio (""), FIND fará a correspondência com o primeiro caractere da cadeia de caracteres de pesquisa (ou seja, o caractere numerado start_num ou 1).
  • Não aparece no within_text, o FIND retorna o #VALUE! valor de erro.

Se start_num:

  • Não é maior que zero (0), o FIND retorna o #VALUE! valor de erro.
  • É maior que o comprimento de within_text, FINDreturns o #VALUE! valor de erro.

Exemplo

FIND ("2003","1º de janeiro de 2003")

Retornará 12.

  • Last updated on