SQLite INSTR

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 Tutorialem busca da substring Tutorial. Ele retorna a posição em SQLite Tutorialque 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 employeestabela e retorna endereços que contêm a SWsubstring.

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 )