PHP 8.4.0 RC4 available for testing

cubrid_move_cursor

(PECL CUBRID >= 8.3.0)

cubrid_move_cursorПеремещает курсор в результате

Описание

cubrid_move_cursor(resource $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"
}

Смотрите также

  • cubrid_execute() - Выполняет подготовленный SQL-оператор

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top