sqlite_query
(PHP 5)
sqlite_query(no version information, might be only in CVS)
SQLiteDatabase->query -- Esegue una query su un database e restituisce un puntatore al set di risultatiDescrizione
resource sqlite_query ( resource dbhandle, string query )resource sqlite_query ( string query, resource dbhandle )
Versione ad oggetti (metodo):
class SQLiteDatabase {SQLiteResult query ( string query )
}
Esegue le istruzioni SQL indicate in query sul collegamento al database dato.
Elenco dei parametri
- query
Query da eseguire.
- dbhandle
Risorsa SQLite Database restituita da sqlite_open () quando usato in modo procedurale. Questo parametro non è richiesto nel metodo ad oggetti.
Nota: Two alternative syntaxes are supported for compatibility with other database extensions (such as MySQL). The preferred form is the first, where the dbhandle parameter is the first parameter to the function.
Valori restituiti
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().
Note
| 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). |