(PECL CUBRID >= 8.3.0)
cubrid_move_cursor — Déplace le curseur dans le résultat
$req_identifier
, int $offset
, int $origin
= CUBRID_CURSOR_CURRENT): bool
La fonction cubrid_move_cursor() est utilisée pour déplacer le
curseur courant suivant le paramètre req_identifier
de la valeur du paramètre offset
et dans la direction
définie par le paramètre origin
argument. Pour définir
l'argument origin
, vous pouvez utiliser CUBRID_CURSOR_FIRST
pour
la première partie du résultat, CUBRID_CURSOR_CURRENT
pour la position courant du résultat,
ou CUBRID_CURSOR_LAST
pour la dernière partie du résultat. Si l'argument origin
n'est pas explicitement désigné, alors la fonction utilisera CUBRID_CURSOR_CURRENT
comme valeur par défaut.
Si la valeur courant du déplacement du curseur est au delà des limites valides, alors
le curseur se déplace à la prochaine position après l'intervalle valide du curseur. Par exemple,
si vous le déplacez de 20 unités dans le résultat dont la taille est de 10, alors le curseur
se placera sur la 11ème place et retournera CUBRID_NO_MORE_DATA
.
req_identifier
Identifiant de requête.
offset
Nombre d'unités que vous voulez utiliser pour le déplacement.
origin
Cible où vous voulez déplacer le curseur, soit CUBRID_CURSOR_FIRST
, CUBRID_CURSOR_CURRENT
, CUBRID_CURSOR_LAST
.
Cette fonction retourne true
en cas de succès ou false
si une erreur survient.
Exemple #1 Exemple avec 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);
?>
L'exemple ci-dessus va afficher :
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" }