SPI_scroll_cursor_move

SPI_scroll_cursor_move — move o cursor

Sinopse

void SPI_scroll_cursor_move(Portal portal, FetchDirection direction,
                            long count)

Descrição

A função SPI_scroll_cursor_move salta um certo número de linhas em um cursor. É equivalente ao comando MOVE do SQL.

Argumentos

Portal portal

portal contendo o cursor

FetchDirection direction

um entre FETCH_FORWARD, FETCH_BACKWARD, FETCH_ABSOLUTE ou FETCH_RELATIVE

long count

número de linhas a serem saltadas por FETCH_FORWARD ou FETCH_BACKWARD; número absoluto da linha para a qual se mover em FETCH_ABSOLUTE; número relativo da linha para a qual se mover em FETCH_RELATIVE

Valor retornado

Se a função for bem-sucedida, SPI_processed é definido como em SPI_execute. SPI_tuptable é definido como NULL, já que nenhuma linha é retornada por esta função.

Notas

Veja o comando FETCH do SQL para obter detalhes sobre a interpretação dos parâmetros direction e count.

Valores de direção diferentes de FETCH_FORWARD podem falhar se o plano do cursor não tiver sido criado com a opção CURSOR_OPT_SCROLL.