SPI_scroll_cursor_move
SPI_scroll_cursor_move — переместить курсор
Синтаксис
void SPI_scroll_cursor_move(Portalportal
, FetchDirectiondirection
, longcount
)
Описание
SPI_scroll_cursor_move
перемещает курсор на несколько строк. Её функциональность равнозначна MOVE
в SQL.
Аргументы
Portal
portal
портал, содержащий курсор
FetchDirection
direction
один из вариантов:
FETCH_FORWARD
,FETCH_BACKWARD
,FETCH_ABSOLUTE
илиFETCH_RELATIVE
long
count
число строк, на которое сдвигается курсор, с направлением
FETCH_FORWARD
илиFETCH_BACKWARD
; абсолютный номер строки, к которой переходит курсор, с направлениемFETCH_ABSOLUTE
; либо относительный номер строки, к которой переходит курсор, с направлениемFETCH_RELATIVE
Возвращаемое значение
В случае успеха переменная SPI_processed
устанавливается как в SPI_execute
. В SPI_tuptable
оказывается NULL
, так как эта функция не возвращает никакие строки.
Примечания
Подробнее о параметрах direction
и count
рассказывается в описании SQL-команды FETCH.
Варианты направления, отличные от FETCH_FORWARD
, могут не поддерживаться, если план курсора был создан без параметра CURSOR_OPT_SCROLL
.