sqlite_unbuffered_query

SQLiteDatabase::unbufferedQuery

(PHP 5 < 5.4.0, PECL sqlite >= 1.0.0)

sqlite_unbuffered_query -- SQLiteDatabase::unbufferedQuery — Execute a query that does not prefetch and buffer all data

Descrierea

sqlite_unbuffered_query ( resource $dbhandle , string $query [, int $result_type = SQLITE_BOTH [, string &$error_msg ]] ) : resource
sqlite_unbuffered_query ( string $query , resource $dbhandle [, int $result_type = SQLITE_BOTH [, string &$error_msg ]] ) : resource

Stil obiect-orientat (method):

public SQLiteDatabase::unbufferedQuery ( string $query [, int $result_type = SQLITE_BOTH [, string &$error_msg ]] ) : SQLiteUnbuffered

sqlite_unbuffered_query() is identical to sqlite_query() except that the result that is returned is a sequential forward-only result set that can only be used to read each row, one after the other.

This function is ideal for generating things such as HTML tables where you only need to process one row at a time and don't need to randomly access the row data.

Notă:

Functions such as sqlite_seek(), sqlite_rewind(), sqlite_next(), sqlite_current(), and sqlite_num_rows() do not work on result handles returned from sqlite_unbuffered_query().

Parametri

dbhandle

The SQLite Database resource; returned from sqlite_open() when used procedurally. This parameter is not required when using the object-oriented method.

query

The query to be executed.

Data inside the query should be properly escaped.

result_type

Parametrul opțional result_type acceptă o constantă și determină cum tablouul întors va fi indexat. Utilizând SQLITE_ASSOC vor fi întorși numai indici asociativi (câmpuri denumite) în timp ce cu SQLITE_NUM vor fi întorși numai indici numerici (numerele de ordine ale câmpurilor). Cu SQLITE_BOTH vor fi întorși atât indici associativi, cât și numerici. SQLITE_BOTH este valoarea implicită pentru această funcție.

error_msg

The specified variable will be filled if an error occurs. This is specially important because SQL syntax errors can't be fetched using the sqlite_last_error() function.

Notă: Două sintaxe alternative sunt susținute pentru compatibilitate cu alte extensii de baze de date (cum ar fi MySQL). Forma preferată este cea dintâi, unde parametrul dbhandle este primul parametru pentru funcție.

Valorile întoarse

Returns a result handle sau FALSE în cazul eșecului.

sqlite_unbuffered_query() returns a sequential forward-only result set that can only be used to read each row, one after the other.

Istoricul schimbărilor

Versiune Descriere
5.1.0 Added the error_msg parameter

A se vedea și

  • sqlite_query() - Executes a query against a given database and returns a result handle