Always use this over the sqlite_fetch_* functions if possible as it's much faster.
sqlite_unbuffered_query
SQLiteDatabase::unbufferedQuery
(PHP 5 < 5.4.0, PECL sqlite >= 1.0.0)
sqlite_unbuffered_query -- SQLiteDatabase::unbufferedQuery — Выполняет запрос без буферизации результатов
Описание
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Объектно-ориентированный стиль (метод):
public SQLiteDatabase::unbufferedQuery
( string
$query
[, int $result_type = SQLITE_BOTH
[, string &$error_msg
]] ) : SQLiteUnbufferedsqlite_unbuffered_query() идентична функции sqlite_query() за исключением того, что записи из возвращаемого результата можно получать только последовательно, одну за другой.
Функция идеально подходит для тех случаев, когда нужно последовательно обработать записи из результата запроса и нет необходимости в доступе к произвольной записи результата запроса, например, при выводе данных из базы данных в виде HTML таблицы.
Замечание:
Функции sqlite_seek(), sqlite_rewind(), sqlite_next(), sqlite_current() и sqlite_num_rows() не работают с результатами, возвращаемыми функцией sqlite_unbuffered_query().
Список параметров
-
dbhandle -
Ресурс базы данных SQLite, полученный из функции sqlite_open() в случае использования процедурного подхода. Параметр не требуется при использовании объектно-ориентированного подхода.
-
query -
Выполняемый запрос.
Данные в запросе должны быть корректно экранированы.
-
result_type -
Необязательный параметр
result_typeпринимает константу, определяющую, как будет индексирован возвращаемый массив. При использованииSQLITE_ASSOCбудет возвращен ассоциативный массив, а при использованииSQLITE_NUM- числовой.SQLITE_BOTHвернет массив как с ассоциативными, так и с числовыми индексами. Значением по умолчанию для этой функции являетсяSQLITE_BOTH. -
error_msg -
Указанная переменная будет заполнена в случае возникновения ошибки. Это особенно важно, так как ошибки синтаксиса SQL не возвращаются функцией sqlite_last_error().
Замечание: Поддерживаются два альтернативных синтаксиса для совместимости с другими расширениями баз данных (например, MySQL). Предпочитаемая форма - первая, в которой параметр
dbhandleявляется первым параметром функции.
Возвращаемые значения
Возвращает дескриптор результата или FALSE в случае возникновения ошибки.
sqlite_unbuffered_query() возвращает последовательный результирующий набор, записи из которого можно читать только вперед, одну за другой.
Список изменений
| Версия | Описание |
|---|---|
| 5.1.0 |
Добавлен параметр error_msg
|
Смотрите также
- sqlite_query() - Выполняет запрос к базе данных и возвращает идентификатор результата
add a note
User Contributed Notes 1 note
radley25 at spamcop net ¶
20 years ago
