INSTR

Descrição

INSTR

é uma função de linha que retorna um número inteiro que indica a posição de um caractere em uma cadeia de caracteres que é o primeiro caractere da ocorrência de uma subcadeia de caracteres. O

INSTR

A função é semelhante à função FIND no Excel, exceto que a primeira letra é a posição 0 e a ordem dos argumentos é invertida.

Sintaxe

INSTR

(

search_string

substring

position

occurrence

)

Valor de retorno

Retorna um valor por linha do tipo

INTEGER

. A primeira posição é indicada com o valor zero (0).

Parâmetros de entrada

search_string: É obrigatório. O nome de um campo ou uma expressão do tipo
TEXT
(ou uma cadeia de caracteres literal).
subcadeia de caracteres: É obrigatório. Uma cadeia de caracteres literal ou o nome de um campo que especifica a subcadeia de caracteres a ser pesquisada em search_string. Observe que para pesquisar as aspas duplas ()
"
) como uma cadeia de caracteres literal, você deve escapá-la com outras aspas duplas:
""
posição: Opcional. Um número inteiro que especifica a partir de qual caractere em search_string para iniciar a pesquisa da subcadeia de caracteres. Um valor de 0 (zero) inicia a pesquisa no início de search_string. Use um número inteiro positivo para começar a pesquisar desde o início de search_stringe use um número inteiro negativo para começar a pesquisar desde o fim de search_string. Quando nenhuma posição é especificada,
INSTR
pesquisa o início da cadeia de caracteres (0).
ocorrência: Opcional. Um número inteiro positivo que especifica qual ocorrência de subcadeia de caracteres deve ser pesquisada. Quando nenhuma ocorrência é especificada,
INSTR
pesquisa a primeira ocorrência da subcadeia de caracteres (1).

Exemplos

Retornar a posição da primeira ocorrência da subcadeia de caracteres "http://" começando do final do campo URL
:

INSTR([url], "http://", -1, 1)

A expressão a seguir pesquisa a segunda ocorrência da subcadeia de caracteres "st", começando do início da cadeia de caracteres "bestteststring". INSTR descobre que a subcadeia de caracteres começa no sétimo caractere na cadeia de caracteres, portanto retorna 6:

INSTR("bestteststring", "st", 0, 2)

A expressão a seguir pesquisa a segunda ocorrência retroativa da subcadeia de caracteres "st", começando com 7 caracteres antes do fim da cadeia de caracteres "bestteststring".

INSTR

encontra que a subcadeia de caracteres começa no terceiro caractere da cadeia de caracteres, portanto, retorna 2:

INSTR("bestteststring", "st", -7, 2)