cubrid_move_cursor
(PECL CUBRID >= 8.3.0)
cubrid_move_cursor — Mover el cursor en el resultado
Descripción
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
CUBRID_CURSOR_SUCCESS, cuando el proceso tiene éxito.
CUBRID_NO_MORE_DATA, cuando no es una posición de cursor válida.
CUBRID_CURSOR_ERROR, en caso de error.
Ejemplos
Example #1 Ejemplo de cubrid_move_cursor()
<?php
$conn = cubrid_connect("127.0.0.1", 33000, "demodb");
$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"
}
