sesam_seek_row
sesam_seek_row
(только PHP 3 CVS)
sesam_seek_row - устанавливает режим прокручиваемого курсора для последовательных извлечений.
Описание
bool sesam_seek_row (string result_id, int whence [, int offset])
result_id это правильный result id (только запросы select type, и только если "scrollable" курсор был запрошен при вызове sesam_query()).
whence устанавливает глобальное значение по умолчанию для типа прокрутки; специфицирует тип прокрутки для использования в последовательных операциях извлечения в "scrollable" курсорах; может иметь значение - следующие предопределённые константы:
Таблица 1. Правильные значения параметра "whence"
| Значение | Константа | Смысл |
|---|---|---|
| 0 | SESAM_SEEK_NEXT | читать последовательно |
| 1 | SESAM_SEEK_PRIOR | читать последовательно в обратном направлении |
| 2 | SESAM_SEEK_FIRST | извлечь первый ряд (после извлечения по умолчанию устанавливается SESAM_SEEK_NEXT) |
| 3 | SESAM_SEEK_LAST | извлечь последний ряд (после извлечения по умолчанию устанавливается SESAM_SEEK_PRIOR) |
| 4 | SESAM_SEEK_ABSOLUTE | извлечь ряд с абсолютным номером offset (С базой 0. После извлечения по умолчанию устанавливается SESAM_SEEK_ABSOLUTE, и выполняется автоинкремент значения смещения) |
| 5 | SESAM_SEEK_RELATIVE | извлечь относительно текущей позиции курсора, где offset может быть положительным или отрицательным значением смещения (также устанавливает "offset"-значение по умолчанию для последовательных вызовов). |
offset это необязательный параметр, который вычисляется (и необходим), только если whence равен SESAM_SEEK_RELATIVE или SESAM_SEEK_ABSOLUTE.