(PECL CUBRID >= 8.3.0)
cubrid_move_cursor — Перемещает курсор в результате
Функция cubrid_move_cursor() используется для перемещения текущего положения курсора req_identifier
на значение, заданное в аргументе offset
, в направлении, заданном в аргументе origin
. Чтобы установить аргумент origin
, вы можете использовать CUBRID_CURSOR_FIRST
для первой части результата, CUBRID_CURSOR_CURRENT
для текущего местоположения результата или CUBRID_CURSOR_LAST
для последней части результата. Если аргумент origin
не указан явно, тогда функция использует CUBRID_CURSOR_CURRENT
в качестве значения по умолчанию.
Если значение диапазона перемещения курсора превышает допустимый предел, то курсор перемещается в следующее место после допустимого диапазона для курсора. Например, если вы переместите 20 единиц в результате с размером 10, то курсор переместится на 11-е место и вернёт CUBRID_NO_MORE_DATA
.
req_identifier
Идентификатор запроса.
offset
Количество единиц, на которые нужно переместить курсор.
origin
Место, из которого вы хотите переместить курсор: CUBRID_CURSOR_FIRST
, CUBRID_CURSOR_CURRENT
или CUBRID_CURSOR_LAST
.
Возвращает true
в случае успешного выполнения или false
, если возникла ошибка.
Пример #1 Пример использования cubrid_move_cursor()
<?php
$conn = cubrid_connect("127.0.0.1", 33000, "demodb", "dba");
$req = cubrid_execute($conn, "SELECT * FROM code");
cubrid_move_cursor($req, 1, CUBRID_CURSOR_LAST);
$result = cubrid_fetch_row($req);
var_dump($result);
cubrid_move_cursor($req, 1, CUBRID_CURSOR_FIRST);
$result = cubrid_fetch_row($req);
var_dump($result);
cubrid_move_cursor($req, 1, CUBRID_CURSOR_CURRENT);
$result = cubrid_fetch_row($req);
var_dump($result);
cubrid_close_request($req);
cubrid_disconnect($conn);
?>
Результат выполнения приведённого примера:
array(2) { [0]=> string(1) "G" [1]=> string(4) "Gold" } array(2) { [0]=> string(1) "X" [1]=> string(5) "Mixed" } array(2) { [0]=> string(1) "M" [1]=> string(3) "Man" }