MOVE(7)			PostgreSQL 9.2.24 Documentation		       MOVE(7)



NAME
       MOVE - position a cursor

SYNOPSIS
       MOVE [ direction [ FROM | IN ] ] cursor_name

       where direction can be empty or one of:

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

DESCRIPTION
       MOVE repositions a cursor without retrieving any data.  MOVE works
       exactly like the FETCH command, except it only positions the cursor and
       does not return rows.

       The parameters for the MOVE command are identical to those of the FETCH
       command; refer to FETCH(7) for details on syntax and usage.

OUTPUTS
       On successful completion, a MOVE command returns a command tag of the
       form

	   MOVE count

       The count is the number of rows that a FETCH command with the same
       parameters would have returned (possibly zero).

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

	   -- Skip the first 5 rows:
	   MOVE FORWARD 5 IN liahona;
	   MOVE 5

	   -- Fetch the 6th row from the cursor liahona:
	   FETCH 1 FROM liahona;
	    code  | title  | did | date_prod  |	 kind  |  len
	   -------+--------+-----+------------+--------+-------
	    P_303 | 48 Hrs | 103 | 1982-10-22 | Action | 01:37
	   (1 row)

	   -- Close the cursor liahona and end the transaction:
	   CLOSE liahona;
	   COMMIT WORK;

COMPATIBILITY
       There is no MOVE statement in the SQL standard.

SEE ALSO
       CLOSE(7), DECLARE(7), FETCH(7)



PostgreSQL 9.2.24		  2017-11-06			       MOVE(7)