mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-08-24 02:17:19 +02:00
Doc: minor improvement in pl/pgsql FETCH/MOVE documentation.
Explain that you can use any integer expression for the "count" in pl/pgsql's versions of FETCH/MOVE, unlike the SQL versions which only allow a constant. Remove the duplicate version of this para under MOVE. I don't see a good reason to maintain two identical paras when we just said that MOVE works exactly like FETCH. Per Pavel Stehule, though I didn't use his text. Discussion: https://postgr.es/m/CAFj8pRAcvSXcNdUGx43bOK1e3NNPbQny7neoTLN42af+8MYWEA@mail.gmail.com
This commit is contained in:
parent
727196ced2
commit
aacdf9a069
@ -3196,6 +3196,10 @@ FETCH <optional> <replaceable>direction</replaceable> { FROM | IN } </optional>
|
|||||||
<literal>BACKWARD</literal>.
|
<literal>BACKWARD</literal>.
|
||||||
Omitting <replaceable>direction</replaceable> is the same
|
Omitting <replaceable>direction</replaceable> is the same
|
||||||
as specifying <literal>NEXT</literal>.
|
as specifying <literal>NEXT</literal>.
|
||||||
|
In the forms using a <replaceable>count</replaceable>,
|
||||||
|
the <replaceable>count</replaceable> can be any integer-valued
|
||||||
|
expression (unlike the SQL <command>FETCH</command> command,
|
||||||
|
which only allows an integer constant).
|
||||||
<replaceable>direction</replaceable> values that require moving
|
<replaceable>direction</replaceable> values that require moving
|
||||||
backward are likely to fail unless the cursor was declared or opened
|
backward are likely to fail unless the cursor was declared or opened
|
||||||
with the <literal>SCROLL</literal> option.
|
with the <literal>SCROLL</literal> option.
|
||||||
@ -3233,26 +3237,6 @@ MOVE <optional> <replaceable>direction</replaceable> { FROM | IN } </optional> <
|
|||||||
be checked to see whether there was a next row to move to.
|
be checked to see whether there was a next row to move to.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
|
||||||
The <replaceable>direction</replaceable> clause can be any of the
|
|
||||||
variants allowed in the SQL <xref linkend="sql-fetch"/>
|
|
||||||
command, namely
|
|
||||||
<literal>NEXT</literal>,
|
|
||||||
<literal>PRIOR</literal>,
|
|
||||||
<literal>FIRST</literal>,
|
|
||||||
<literal>LAST</literal>,
|
|
||||||
<literal>ABSOLUTE</literal> <replaceable>count</replaceable>,
|
|
||||||
<literal>RELATIVE</literal> <replaceable>count</replaceable>,
|
|
||||||
<literal>ALL</literal>,
|
|
||||||
<literal>FORWARD</literal> <optional> <replaceable>count</replaceable> | <literal>ALL</literal> </optional>, or
|
|
||||||
<literal>BACKWARD</literal> <optional> <replaceable>count</replaceable> | <literal>ALL</literal> </optional>.
|
|
||||||
Omitting <replaceable>direction</replaceable> is the same
|
|
||||||
as specifying <literal>NEXT</literal>.
|
|
||||||
<replaceable>direction</replaceable> values that require moving
|
|
||||||
backward are likely to fail unless the cursor was declared or opened
|
|
||||||
with the <literal>SCROLL</literal> option.
|
|
||||||
</para>
|
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
Examples:
|
Examples:
|
||||||
<programlisting>
|
<programlisting>
|
||||||
|
@ -99,7 +99,7 @@ FETCH [ <replaceable class="parameter">direction</replaceable> [ FROM | IN ] ] <
|
|||||||
This page describes usage of cursors at the SQL command level.
|
This page describes usage of cursors at the SQL command level.
|
||||||
If you are trying to use cursors inside a <application>PL/pgSQL</application>
|
If you are trying to use cursors inside a <application>PL/pgSQL</application>
|
||||||
function, the rules are different —
|
function, the rules are different —
|
||||||
see <xref linkend="plpgsql-cursors"/>.
|
see <xref linkend="plpgsql-cursor-using"/>.
|
||||||
</para>
|
</para>
|
||||||
</note>
|
</note>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
Loading…
Reference in New Issue
Block a user