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
Опис
$dbhandle
, string $query
[, int $result_type = SQLITE_BOTH
[, string &$error_msg
]] )$query
, resource $dbhandle
[, int $result_type = SQLITE_BOTH
[, string &$error_msg
]] )Об'єктно-орієнтований стиль (method):
$query
[, int $result_type = SQLITE_BOTH
[, 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.
Зауваження:
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().
Параметри
-
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 -
The optional
result_typeparameter accepts a constant and determines how the returned array will be indexed. UsingSQLITE_ASSOCwill return only associative indices (named fields) whileSQLITE_NUMwill return only numerical indices (ordinal field numbers).SQLITE_BOTHwill return both associative and numerical indices.SQLITE_BOTHis the default for this function. -
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.
Зауваження: Two alternative syntaxes are supported for compatibility with other database extensions (such as MySQL). The preferred form is the first, where the
dbhandleparameter is the first parameter to the function.
Значення, що повертаються
Returns a result handle або FALSE в разі помилки.
sqlite_unbuffered_query() returns a sequential forward-only result set that can only be used to read each row, one after the other.
Журнал Змін
| Версія | Опис |
|---|---|
| 5.1.0 |
Added the error_msg parameter
|
Прогляньте Також
- sqlite_query() - Executes a query against a given database and returns a result handle
add a note
