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().