Manual do PHP
Anterior |  | Próxima

# sqlite_query

(PHP 5)

sqlite_query -- Executa uma query em um banco de dados e retorna um conjunto de resultados.

## Descrição

resource sqlite_query ( resource dbhandle, string query )
resource sqlite_query ( string query, resource dbhandle )

Executa uma SQL indicada pelo parâmetro `query` com um banco de dados (especificado pelo parâmetro `dbhandle`).

Para query que retornam linhas, esta função irá retornar um result handle que pode ser usado em funções como sqlite_fetch_array() e sqlite_seek().

Para outros tipos de query, esta função irá retornar um resultado booleano; `TRUE` para sucesso ou `FALSE` para falha.

Qualquer que seja o tipo da query, esta função irá retornar `FALSE` se houver uma falha.

sqlite_query() retorna um resultado guardado em buffer e navegavel. Isto é util para query pequenas aonde você necessita acessar de forma aleatória as linhas. Resultados guardados em buffer irão alocar memoria para guardar todo o resultado e não irão retornar até que todo o resultado tenha sido retornado. Se você necessita apenas acesso sequencial aos dados, é recomendado que você use ao invés a função sqlite_unbuffered_query() que é muito mais rapida.

> Nota: Duas maneiras alternativas são suportadas para compatibilidade com outros bancos de dados(como o MySQL). A forma preferida é a primeira, aonde o parâmetro `db` é o primeiro na função.

Atenção
SQLite irá executar multiplas query separadas por ponto e virgula, assimvocê pode executar um lote de SQL que você tenha carregado de um arquivo ou colocado em um script. Entretando, isto funciona apenas quando o resultado de uma função não é usado - se for usado, apenas o primeiro comando SQL será executado. A função sqlite_exec() irá sempre executar multiplos comandos SQL. Quando executar multiplas query o valor de retorno desta função será `FALSE` se houver um erro, mas indefinido em outro caso (pode ser `TRUE` para sucesso ou retornar um conjunto de resultados).

Veja também sqlite_unbuffered_query() e sqlite_array_query().

Anterior | Principal | Próxima
sqlite_prev | Acima | sqlite_rewind