Desplaza el cursor en el resultado

# cubrid_move_cursor

(PECL CUBRID >= 8.3.0)

cubrid_move_cursor — Desplaza el cursor en el resultado

### Descripción

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

La función cubrid_move_cursor() se utiliza para desplazar el cursor actual según el parámetro `req_identifier` con el valor del parámetro `offset` y en la dirección definida por el parámetro `origin` argumento. Para definir el argumento `origin`, se puede utilizar `CUBRID_CURSOR_FIRST` para la primera parte del resultado, `CUBRID_CURSOR_CURRENT` para la posición actual del resultado, o `CUBRID_CURSOR_LAST` para la última parte del resultado. Si el argumento `origin` no es explícitamente designado, entonces la función utilizará `CUBRID_CURSOR_CURRENT` como valor por omisión.

Si el valor actual del desplazamiento del cursor está más allá de los límites válidos, entonces el cursor se desplaza a la siguiente posición después del intervalo válido del cursor. Por ejemplo, si se desplaza 20 unidades en el resultado cuyo tamaño es de 10, entonces el cursor se colocará en la 11ª posición y devolverá `CUBRID_NO_MORE_DATA`.

### Parámetros

`req_identifier`
  Identificador de la consulta.
`offset`
  Número de unidades que se desean utilizar para el desplazamiento.
`origin`
  Objetivo donde se desea desplazar el cursor, ya sea `CUBRID_CURSOR_FIRST`, `CUBRID_CURSOR_CURRENT`, `CUBRID_CURSOR_LAST`.

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

### Ejemplos

Ejemplo #1 Ejemplo con 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);
    ?>

El ejemplo anterior mostrará:

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

### Ver también

- cubrid_execute() - Ejecutar una sentencia SQL preparada

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