array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.cubrid-move-cursor.php', 1 => 'cubrid_move_cursor', 2 => 'Desplaza el cursor en el resultado', ), 'up' => array ( 0 => 'ref.cubrid.php', 1 => 'Funciones de CUBRID', ), 'prev' => array ( 0 => 'function.cubrid-lock-write.php', 1 => 'cubrid_lock_write', ), 'next' => array ( 0 => 'function.cubrid-next-result.php', 1 => 'cubrid_next_result', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/cubrid/functions/cubrid-move-cursor.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

cubrid_move_cursor

(PECL CUBRID >= 8.3.0)

cubrid_move_cursor — Desplaza 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 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