# cubrid_move_cursor

(PECL CUBRID >= 8.3.0)

cubrid_move_cursor — Mover el cursor en el resultado

### Descripción

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

La función cubrid_move_cursor() se usa para mover la posición del cursor actual de `req_handle` por el valor establecido en el argumento `offset`, a la dirección establecida en el argumento `origin`. Para establecer el argumento `origin` se puede usar CUBRID_CURSOR_FIRST como primera parte del resultado, CUBRID_CURSOR_CURRENT como la posición actual del resultado, o CUBRID_CURSOR_LAST como la última parte del resultado. Si el argumento `origin` no es designado explícitamente, la función usa CUBRID_CURSOR_CURRENT como valor predeterminado.

Si el valor del alcance de movimiento del cursor se sale del límite válido, el cursor se mueve a la siguiente posición después del alcance válido del cursor. Por ejemplo, si se mueve 20 unidades en un resultado cuyo tamaño es 10, el cursor se moverá al lugar 11 y devolverá CUBRID_NO_MORE_DATA.

### Parámetros

`req_identifier`

  Identificador de solicitud.

`offset`

  Número de unidades que se quiere mover el cursor.

`origin`

  Posición donde se quiere mover el cursor desde CUBRID_CURSOR_FIRST, CUBRID_CURSOR_CURRENT, CUBRID_CURSOR_LAST.

### Valores devueltos

`true`, cuando el proceso tiene éxito.

`false`, cuando el proceso no tiene éxito.

### Ejemplos

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

El resultado del ejemplo sería:

    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