Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

INSTR

Retorna a posição de caractere da primeira ocorrência de uma string dentro de outra string; retorna 0 se a string procurada não for encontrada.

Veja também:
[SELECT]


Sintaxe​

SELECT INSTR(string, searchstring) FROM <multipartIdentifier>;

Argumentos​

string
A string de origem na qual a busca é feita.

searchstring
A substring procurada.

Se string e searchstring forem ambos BLOBs, instr(<string>, <searchstring>) retorna o número de bytes anteriores à primeira ocorrência de searchstring mais um, ou 0 se searchstring não ocorrer em nenhum lugar de string. Se os dois argumentos não forem NULL e não forem BLOBs, ambos serão interpretados como strings.

Valor(es) retornado(s)​

Retorna um inteiro.

Se o valor de string ou de searchstring for NULL, o resultado será NULL.


Exemplos​

Procurar uma string em um campo​

SELECT INSTR(name, 'worker') as charpos
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
/*
returns 0 if the term 'worker' is not present in the 'name' column, otherwise returns the character position (starting from 1) of the first occurrence of the term 'worker' in the 'name' column
*/

Para obter mais informações, consulte https://www.sqlite.org/lang_corefunc.html#instr