sesam_query
sesam_query
(только PHP 3 CVS)
sesam_query - выполняет SESAM SQL-запрос и готовит результат.
Описание
string sesam_query (string query [, bool scrollable])
Возвращает SESAM "result identifier" при успехе, FALSE при ошибке.
Ресурс "result_id" используется другими функциями для запрашивания результатов выполнения query/запроса.
sesam_query() отправляет запрос текущей активной БД на сервере. Могут выполняться как "immediate" SQL-операторы, так и "select type" запросы. Если выполняется "immediate" оператор, то курсор не выделяется, а последующий вызов sesam_fetch_row() или sesam_fetch_result() возвращает пустой результат (нулевые столбцы, указывающие end-of-result). Для "select type" операторов выделяются дескриптор результата и (прокручиваемый или последовательный, в зависимости от необязательного булева параметра scrollable) курсор. Если scrollable отсутствует, курсор будет последовательным/sequential.
При использовании "scrollable" курсоров курсор может свободно позиционироваться в результирующем наборе. Для каждого "scrollable" запроса имеются глобальные значения по умолчанию для прокручиваемого/scrolling типа (инициализируется: SESAM_SEEK_NEXT) и смещение прокрутки, которое может быть установлено однократно функцией sesam_seek_row(), либо каждый раз при извлечении ряда функцией sesam_fetch_row().
Для "immediate" операторов количество задействованных рядов сохраняется для запрашивания функцией sesam_affected_rows().
См. также sesam_fetch_row() и sesam_fetch_result().