====
MOVE
====


.. container:: refentry
   :name: SQL-MOVE

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: MOVE
         :name: move

      MOVE — 定位一个游标

   .. container:: refsynopsisdiv

      .. rubric:: 大纲
         :name: 大纲

      .. code:: synopsis

         MOVE [ direction [ FROM | IN ] ] cursor_name

         其中direction可以为空或者以下之一：

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

   .. container:: refsect1
      :name: id-1.9.3.156.6

      .. rubric:: 描述
         :name: 描述

      ``MOVE``\ 重新定位一个游标而不检索任何数据。
      ``MOVE``\ 的工作完全像
      ``FETCH``\ 命令，但是它只定位游标并且不返回行。

      用于\ ``MOVE``\ 命令的参数和 ``FETCH``\ 命令的一样，可参考
      `FETCH <sql-fetch.html>`__\ 。

   .. container:: refsect1
      :name: id-1.9.3.156.7

      .. rubric:: 输出
         :name: 输出

      成功完成时，\ ``MOVE``\ 命令返回的命令标签形式是

      .. code:: screen

         MOVE count

      ``count``\ 是一个 具有同样参数的\ ``FETCH``\ 命令会返回的
      行数（可能为零）。

   .. container:: refsect1
      :name: id-1.9.3.156.8

      .. rubric:: 示例
         :name: 示例

      .. code:: programlisting

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

         -- 跳过前 5 行：
         MOVE FORWARD 5 IN liahona;
         MOVE 5

         -- 从游标 liahona 中取第 6 行：
         FETCH 1 FROM liahona;
          code  | title  | did | date_prod  |  kind  |  len
         -------+--------+-----+------------+--------+-------
          P_303 | 48 Hrs | 103 | 1982-10-22 | Action | 01:37
         (1 row)

         -- 关闭游标 liahona 并且结束事务：
         CLOSE liahona;
         COMMIT WORK;

   .. container:: refsect1
      :name: id-1.9.3.156.9

      .. rubric:: 兼容性
         :name: 兼容性

      在 SQL 标准中没有\ ``MOVE``\ 语句。

   .. container:: refsect1
      :name: id-1.9.3.156.10

      .. rubric:: 另见
         :name: 另见

      `CLOSE <sql-close.html>`__, `DECLARE <sql-declare.html>`__,
      `FETCH <sql-fetch.html>`__