PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

SPI_scroll_cursor_move

SPI_scroll_cursor_move — 移动一个游标

Synopsis

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

描述

SPI_scroll_cursor_move 在一个游标中跳过 一定数量的行。 这等价于 SQL 命令 MOVE。

参数

Portal 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 命令。

如果游标的计划不是用 CURSOR_OPT_SCROLL 选项创建的, FETCH_FORWARD 之外的方向值可能 失败。