Forum und email

sqlite_unbuffered_query

SQLiteDatabase->unbufferedQuery

(No version information available, might be only in CVS)

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

Popis

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

Object oriented style (method):

SQLiteDatabase
SQLiteUnbuffered unbufferedQuery ( string $query [, int $result_type [, string &$error_msg ]] )

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.

Note: 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().

Parametre

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.

result_type

Voliteľný result_type parameter akceptuje konštantu a určuje ako sa bude vrátené pole indexovať. Použitie SQLITE_ASSOC vráti iba asociatívne indexy (nazývané polia) zatiaľčo SQLITE_NUM vráti iba číselné indexy (rádové čísla poľa). SQLITE_BOTH vráti obe asociatívne a číselné indexy. SQLITE_BOTH je východzia pre túto funkciu.

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.

Note: Sú podporované dva alternatívne syntaxe kvôli kompatibilite s inými databázovými rozšíreniami (ako MySQL). Preferovaná forma je prvá, kde parameter dbhandle je prvým parametrom funkcie.

Vrátené hodnoty

Returns a result handle or FALSE on failure.

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

ChangeLog

Verzia Popis
5.1.0 Added the error_msg parameter

Tiež pozri