Каталог документации / Раздел "PHP" / Оглавление документа

Учебник РНР
Назад		Вперёд

sesam_fetch_result

(только PHP 3 CVS)

sesam_fetch_result - возвращает все части результата запроса.

Описание

mixed sesam_fetch_result (string result_id [, int max_rows])

Возвращает смешанный массив с вхождениями результата запроса, по выбору ограниченный максимумом рядов в параметре max_rows. Обратите внимание, что индексы рядов и столбцов имеют базу 0.

Таблица 1. Смешанный результирующий набор, возвращаемый функцией sesam_fetch_result()

элемент массива	содержимое
int $arr["count"]	количество столбцов в результирующем наборе (или нуль, если это был "immediate" запрос)
int $arr["rows"]	количество столбцов в результирующем наборе (от нуля до `max_rows`)
bool $arr["truncated"]	`TRUE`, если количество рядов было не менее `max_rows`, иначе `FALSE`. Обратите внимание, что даже если этот элемент `TRUE`, следующий вызов sesam_fetch_result() может вернуть ноль рядов, поскольку больше нет результирующих вхождений.
mixed $arr[col][row]	результирующие данные для всех полей row(`row`) и column(`col`), (где integer индекс `row` находится между 0 и `$arr["rows"]-1`, а `col` - между 0 и `$arr["count"]-1`). Поля могут быть пустыми, поэтому вы обязаны проверять существование поля с помощью РНР-функции isset() . Тип возвращаемых полей зависит от соответствующего SQL-типа, объявленного для данного столбца (см. в разделе SESAM. Обзор. о применяемых конвертациях). SESAM "multiple fields" являются "inlined" и рассматриваются как последовательность столбцов.

Заметьте, что количество памяти, используемой большим запросом, может быть гигантским. Используйте параметр max_rows для ограничения максимального количества возвращаемых рядов, если только вы не уверены, что ваш результат не будет использовать всю доступную память.

См. также sesam_fetch_row() и sesam_field_array() о проверке на наличие "multiple fields". См. в описании функции sesam_query() полный пример использования sesam_fetch_result().

Назад	Оглавление	Вперёд
sesam_fetch_array	Вверх	sesam_fetch_row

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру