sesam_fetch_result()

Функции PHP

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Sep

2010

sesam_fetch_result()

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

Комментарии

Добавить новый

Поиск