# 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`, 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`.

### Liste de paramètres

`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`.

### 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

- cubrid_execute() - Exécute une requête SQL préparée