O SQLite INSTR pesquisa uma substring em uma string e retorna um número inteiro que indica a posição da substring, que é o primeiro caractere da substring.
Se a substring não aparecer na string, a função INSTR retorna 0. Caso a string ou substring seja NULL, a função INSTR retorna um valor NULL.
Observe que a função INSTR também funciona com o tipo de dados BLOB.
Sintaxe
A instrução a seguir mostra a sintaxe da função INSTR:
INSTR(string, substring);
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Argumentos
A função INSTR aceita dois argumentos.
corda
é a string de origem que a função INSTR procura pela substring
substring
é a substring usada para pesquisar.
Tipo de retorno
Inteiro
Exemplos
O exemplo a seguir pesquisa a string SQLite Tutorial
em busca da substring Tutorial
. Ele retorna a posição em SQLite Tutorial
que começa a primeira ocorrência de Tutorial
.
SELECT INSTR('SQLite Tutorial','Tutorial') position;
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
position
------------
8
O INSTR procura a substring com distinção entre maiúsculas e minúsculas. Por exemplo, a instrução a seguir retorna a primeira ocorrência da substring I e não i.
SELECT INSTR('SQLite INSTR', 'I');
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
A instrução a seguir seleciona a employees
tabela e retorna endereços que contêm a SW
substring.
SELECT lastname,
firstname,
address,
INSTR(address, 'SW') sw
FROM employees
WHERE sw > 0;
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
É equivalente à seguinte instrução que usa o operador LIKE :
SELECT lastname,
firstname,
address
FROM employees
WHERE address LIKE '%SW%';
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )