Documentación offline PHP master

cubrid_move_cursor

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

cubrid_move_cursor

Desplaza el cursor en el resultado

Descripción#

cubrid_move_cursor(resource $req_identifier, int $offset, [int $origin]): bool
```php

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 con `cubrid_move_cursor`

```php

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

Véase también#

cubrid_execute