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

# cubrid_move_cursor

(PECL CUBRID >= 8.3.0)

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

### Описание

function 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-оператор

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open