Déplace le curseur dans le résultat

# cubrid_move_cursor

(PECL CUBRID >= 8.3.0)

cubrid_move_cursor — Déplace le curseur dans le résultat

### Description

function 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`. Pour définir le paramètre `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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open