SPI_scroll_cursor_move <refpurpose>move a cursor</refpurpose> — カーソルを移動する
void SPI_scroll_cursor_move(Portalportal
, FetchDirectiondirection
, longcount
)
<function>SPI_scroll_cursor_move</function> skips over some number of rows
in a cursor. This is equivalent to the SQL command
<command>MOVE</command>.
SPI_scroll_cursor_move
はカーソル内の行の一部をスキップします。
これはSQLコマンドMOVE
と等価です。
Portal portal
portal containing the cursor カーソルを含むポータル
FetchDirection direction
one of <symbol>FETCH_FORWARD</symbol>,
<symbol>FETCH_BACKWARD</symbol>,
<symbol>FETCH_ABSOLUTE</symbol> or
<symbol>FETCH_RELATIVE</symbol>
FETCH_FORWARD
、FETCH_BACKWARD
、FETCH_ABSOLUTE
、FETCH_RELATIVE
のいずれか
long count
number of rows to move for
<symbol>FETCH_FORWARD</symbol> or
<symbol>FETCH_BACKWARD</symbol>; absolute row number to move to for
<symbol>FETCH_ABSOLUTE</symbol>; or relative row number to move to for
<symbol>FETCH_RELATIVE</symbol>
FETCH_FORWARD
またはFETCH_BACKWARD
では移動する行数。
FETCH_ABSOLUTE
では移動する行の絶対番号。
FETCH_RELATIVE
では移動する行の相対的番号。
<varname>SPI_processed</varname> is set as in
<function>SPI_execute</function> if successful.
<varname>SPI_tuptable</varname> is set to <symbol>NULL</symbol>, since
no rows are returned by this function.
成功時、SPI_execute
同様にSPI_processed
が設定されます。
この関数は行を返しませんので、SPI_tuptable
はNULL
に設定されます。
See the SQL <xref linkend="sql-fetch"/> command
for details of the interpretation of the
<parameter>direction</parameter> and
<parameter>count</parameter> parameters.
direction
パラメータおよびcount
パラメータの解釈の詳細についてはSQL FETCHコマンドを参照してください。
Direction values other than <symbol>FETCH_FORWARD</symbol>
may fail if the cursor's plan was not created
with the <symbol>CURSOR_OPT_SCROLL</symbol> option.
カーソルの計画がCURSOR_OPT_SCROLL
オプション付きで作成されていない場合、FETCH_FORWARD
以外の方向値は失敗する可能性があります。