Manuale PHP
Indietro |  | Avanti

# 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 risultati

## Descrizione

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

## Vedere anche:

sqlite_unbuffered_query()
sqlite_array_query()

Indietro | Partenza | Avanti
sqlite_prev | Risali | sqlite_rewind