Compartilhar via


Função LOOKUP

Retorna um índice baseado em zero que indica o local da chave de substring em uma lista ou retorna -1 se a cadeia de caracteres de destino contiver o delimitador.

Sintaxe

LOOKUP(" key "," list "[", delimitador "])

Parâmetros

Name Obrigatório/opcional Tipo de dados Descrição
key
Obrigatório
String
A cadeia de caracteres que você deseja procurar.
list
Obrigatório
String
A lista na qual deseja fazer a pesquisa.
delimitador
Opcional
String
A cadeia de caracteres para ser usada como um delimitador na list. Uma cadeia de caracteres do delimiter pode ter mais de um caractere e pode incluir caracteres de multibyte. O padrão é um ponto-e-vírgula.

Valor de retorno

Numérico

Comentários

A função LOOKUP utiliza uma pesquisa sem fazer diferenciação entre maiúsculas e minúsculas. Se a lista começar ou terminar com um delimitador, presume-se a existência de uma sequência de caracteres nula antes ou depois da lista. Delimitadores consecutivos implicam uma sequência de caracteres nula entre eles.

Todos os argumentos devem ser cadeias de caracteres ou expressões que podem ser convertidas em cadeias de caracteres. Caso contrário, uma cadeia de caracteres vazia substituirá o argumento errado.

Exemplo 1

LOOKUP("rat", "cat; Rato;; cabra")

Retornará 1.

Exemplo 2

LOOKUP("","; Gato; Rato;; cabra")

Retornará 0.

Exemplo 3

LOOKUP("t", "cat; Rato;; goat","a")

Retornará 3.