array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.cubrid-move-cursor.php', 1 => 'cubrid_move_cursor', 2 => 'Déplace le curseur dans le résultat', ), 'up' => array ( 0 => 'ref.cubrid.php', 1 => 'Fonctions 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' => 'fr', '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 — Déplace le curseur dans le résultat

Description

cubrid_move_cursor(resource $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, il est possible d'utiliser CUBRID_CURSOR_FIRST pour la première partie du résultat, CUBRID_CURSOR_CURRENT pour la position courante 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 courante 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 on le déplace de 20 unités dans le résultat dont la taille est de 10, alors le curseur se place sur la 11ème place et retournera CUBRID_NO_MORE_DATA.

Liste de paramètres

req_identifier
Identifiant de requête.
offset
Nombre d'unités que l'on veut utiliser pour le déplacement.
origin
Cible où l'on veut déplacer le curseur, soit CUBRID_CURSOR_FIRST, CUBRID_CURSOR_CURRENT, CUBRID_CURSOR_LAST.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

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

Voir aussi