cubrid_move_cursor

(PECL CUBRID >= 8.3.0)

cubrid_move_cursorMover 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($req1CUBRID_CURSOR_LAST);

$result cubrid_fetch_row($req);
var_dump($result);

cubrid_move_cursor($req1CUBRID_CURSOR_FIRST);
$result cubrid_fetch_row($req);
var_dump($result);

cubrid_move_cursor($req1CUBRID_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