Manual do PHP
Anterior |  | Próxima

# sqlite_query

(no version information, might be only in CVS)

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. 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_popen | Acima | sqlite_rewind