sqlite_query

Manuale PHP
Indietro		Avanti

Descrizione

resource sqlite_query ( resource dbhandle, string query )

resource sqlite_query ( string query, resource dbhandle )

Esegue le istruzioni SQL indicate in query sul collegamento al database indicato dal parametro dbhandle.

Questa funzione restituisce un handle o FALSE se si verifica un errore. Nei casi di query che restituiscano delle righe, l'handle restituito dalla funzione può essere utilizzato nelle funzioni sqlite_fetch_array() e sqlite_seek().

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

Indietro	Partenza	Avanti
sqlite_prev	Risali	sqlite_rewind