SPI_scroll_cursor_move
名前
SPI_scroll_cursor_move -- カーソルを移動する
概要
void SPI_scroll_cursor_move(Portal portal, FetchDirection direction,
long count)
説明
SPI_scroll_cursor_move
はカーソル内の行の一部を飛ばします。
これはSQLコマンドMOVEと等価です。
引数
- Portal portal
カーソルを含むポータル
- FetchDirection direction
FETCH_FORWARD、FETCH_BACKWARD、FETCH_ABSOLUTE、FETCH_RELATIVEのいずれか
- long count
FETCH_FORWARDまたはFETCH_BACKWARDでは移動する行数。
FETCH_ABSOLUTEでは移動する行の絶対番号。
FETCH_RELATIVEでは移動する行の相対的番号。
戻り値
成功時、SPI_execute
同様にSPI_processedが設定されます。
この関数は行を返しませんので、SPI_tuptableはNULLに設定されます。
注釈
directionパラメータおよびcountパラメータの解釈の詳細についてはSQL FETCHコマンドを参照してください。
カーソルの計画がCURSOR_OPT_SCROLLオプション付きで作成されていない場合、FETCH_FORWARD以外の方向値は失敗する可能性があります。