Move o cursor no resultado

# cubrid_move_cursor

(PECL CUBRID >= 8.3.0)

cubrid_move_cursor — Move o cursor no resultado

### Descrição

function cubrid_move_cursor(resource `$req_identifier`, int `$offset`, int `$origin` = CUBRID_CURSOR_CURRENT): bool

A função cubrid_move_cursor() é usada para mover a posição atual do cursor de `req_identifier` pelo valor definido no argumento `offset`, na direção definida no argumento `origin`. Para definir o argumento `origin`, pode-se usar `CUBRID_CURSOR_FIRST` para a primeira parte do resultado, `CUBRID_CURSOR_CURRENT` para a posição atual do resultado ou `CUBRID_CURSOR_LAST` para a última parte do resultado. Se o argumento `origin` não for explicitamente designado, a função usará `CUBRID_CURSOR_CURRENT` como seu valor padrão.

Se o valor da faixa de movimento do cursor ultrapassar o limite válido, o cursor será movido para a próxima posição após a faixa válida para o cursor. Por exemplo, se a intenção for mover 20 unidades no resultado com tamanho de 10, o cursor será movido para a 11ª posição e retornará `CUBRID_NO_MORE_DATA`.

### Parâmetros

`req_identifier`
  Identificador da requisição.
`offset`
  Número de unidades que se deseja mover o cursor.
`origin`
  Posição a partir da qual se deseja mover o cursor: `CUBRID_CURSOR_FIRST`, `CUBRID_CURSOR_CURRENT` ou `CUBRID_CURSOR_LAST`.

### Valor Retornado

Retorna `true` em caso de sucesso ou `false` em caso de falha.

### Exemplos

Exemplo #1 Exemplo de 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);
    ?>

O exemplo acima produzirá:

    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"
    }

### Veja Também

- cubrid_execute() - Executa uma instrução preparada SQL

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