Documentation PostgreSQL 14.22 » Référence » Commandes SQL » MOVE

Précédent | Niveau supérieur | Suivant
LOCK | Sommaire | NOTIFY

## MOVE

MOVE — positionner un curseur

## Synopsis

    MOVE [ direction ] [ FROM | IN ] nom_curseur

    où direction peut faire partie de :

        NEXT
        PRIOR
        FIRST
        LAST
        ABSOLUTE nombre
        RELATIVE nombre
        nombre
        ALL
        FORWARD
        FORWARD nombre
        FORWARD ALL
        BACKWARD
        BACKWARD nombre
        BACKWARD ALL

## Description

`MOVE` repositionne un curseur sans retourner de donnée. `MOVE` fonctionne exactement comme la commande `FETCH` à la différence que `MOVE` ne fait que positionner le curseur et ne retourne aucune ligne.

Les paramètres de la commande `MOVE` sont identiques à ceux de la commande `FETCH`. FETCH contient les détails de syntaxe et d'utilisation.

## Sortie

En cas de réussite, une commande `MOVE` retourne une balise de commande de la forme

    MOVE compteur

`compteur` est le nombre de lignes qu'une commande `FETCH` avec les mêmes paramètres aurait renvoyée (éventuellement zéro).

## Exemples

    BEGIN WORK;
    DECLARE liahona CURSOR FOR SELECT * FROM films;

    -- Saute les 5 premières lignes :
    MOVE FORWARD 5 IN liahona;
    MOVE 5

    -- Récupère la 6ème ligne à partir du curseur liahona :
    FETCH 1 FROM liahona;
     code  | titre  | did | date_prod  | genre  |  longueur
    -------+--------+-----+------------+--------+-----------
     P_303 | 48 Hrs | 103 | 1982-10-22 | Action | 01:37
    (1 row)

    -- Ferme le curseur liahona et termine la transaction :
    CLOSE liahona;
    COMMIT WORK;

## Compatibilité

Il n'existe pas d'instruction `MOVE` dans le standard SQL.

## Voir aussi

CLOSE, DECLARE, FETCH