(PHP 5)
sqlite_query -- Esegue una query su un database e restituisce un puntatore al set di risultati.Esegue le istruzioni SQL indicate in query sul collegamento al database indicato dal parametro dbhandle.
Nei casi di query che restituiscano delle righe, questa funzione restituisce un handle che può essere utilizzato nelle funzioni sqlite_fetch_array() e sqlite_seek().
Negli altri tipi di query, questa funzione restituirà un risultato booleano; TRUE se la query ha successo, FALSE se non riesce.
A prescindere dal tipo di query, questa funzione restituisce FALSE se la query fallisce.
sqlite_query() restituisce un puntatore ad un set di risultati bufferizzato e navigabile. Ciò è ragionevole per piccole query dove si ha la necessità di accedere alle righe in ordine casuale. I risultati bufferizzati allocano la memoria necessaria per contenere tutte le righe restituite dalla query, che non saranno restituite fino a che non saranno richieste. Se si ha soltanto la necessità di accedere alle righe in modo sequenziale, si raccomanda l'uso della funzione sqlite_unbuffered_query().
Nota: Sono supportate due sintassi alternative, questo per compatibilità con altri moduli per database (esempio MySql). La forma preferita è la prima, in cui il parametro db è il primo della funzione.
| Avvertimento |
SQLite esegue molteplici query separate da punto e virgola, pertanto si possono eseguire dei batch SQL che possono essere caricati da file esterni o inseriti nello script. Tuttavia ciò è valido solo quando non è utilizzato il risultato della funzione, se, al contrario, viene utilizzato, verrà eseguito solo la prima query. Funzioni tipo sqlite_exec() eseguono sempre molteplici query SQL. Quando si eseguono query molteplici, il valore restituito può essere FALSE se vi è un errore, oppure indefinito in caso contrario ( può essere TRUE oppure può restituire un handle ad un set di risultati). |
Vedere anche sqlite_unbuffered_query() e sqlite_array_query().