cubrid_move_cursor
(PECL CUBRID >= 8.3.0)
cubrid_move_cursor — Перемещает курсор в результате
Описание
$req_identifier, int $offset, int $origin = CUBRID_CURSOR_CURRENT): bool
Функция 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"
}
add a note
