SPI_scroll_cursor_fetch
SPI_scroll_cursor_fetch — fetch some rows from a cursor
Synopsis
void SPI_scroll_cursor_fetch(Portalportal
, FetchDirectiondirection
, longcount
)
Description
SPI_scroll_cursor_fetch
fetches some rows from a cursor. This is equivalent to the SQL commandFETCH
.
Arguments
Portal
portal
portal containing the cursor
FetchDirection
direction
one of
FETCH_FORWARD
,FETCH_BACKWARD
,FETCH_ABSOLUTE
orFETCH_RELATIVE
long
count
number of rows to fetch for
FETCH_FORWARD
orFETCH_BACKWARD
; absolute row number to fetch forFETCH_ABSOLUTE
; or relative row number to fetch forFETCH_RELATIVE
Return Value
SPI_processed
andSPI_tuptable
are set as inSPI_execute
if successful.
Notes
See the SQLFETCH command for details of the interpretation of thedirection
andcount
parameters.
Direction values other thanFETCH_FORWARD
may fail if the cursor's plan was not created with theCURSOR_OPT_SCROLL
option.