SQLite Функции
PHP Manual

sqlite_unbuffered_query

SQLiteDatabase->unbufferedQuery

(PHP 5, PECL sqlite >= 1.0.0)

sqlite_unbuffered_query -- SQLiteDatabase->unbufferedQueryExecute a query that does not prefetch and buffer all data

Описание

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.

Забележка: 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

Незадължителният параметър result_type приема константата и определя как да се индексира върнатия масив. Ако е зададена SQLITE_ASSOC, ще връща само асоциативни индекси (имената на полетата), а при SQLITE_NUM ще връща само числови индекси (редни числа на полетата). При SQLITE_BOTH ще връща и асоциативни и числови индекси. Стойността по подразбиране за тази функция е SQLITE_BOTH.

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.

Забележка: С цел съвместимост с други разширения за бази от данни (като MySQL) се поддържат два алтернативни синтаксиса. За предпочитане е първият, при който параметъра dbhandle е първият параметър на функцията.

Връщани стойности

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.

Дневник на промените

Версия Описание
5.1.0 Added the error_msg parameter

Вж. също


SQLite Функции
PHP Manual