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