Rb Cafe » Postgres » Documentation PostgreSQL 13.10 » Programmation serveur » Interface de programmation serveur » Fonctions d'interface » SPI_scroll_cursor_move

SPI_scroll_cursor_move

SPI_scroll_cursor_move — déplacer un curseur

Synopsis

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

Description

SPI_scroll_cursor_move ignore un certain nombre de lignes dans un curseur. C'est l'équivalent de la commande SQL MOVE.

Arguments

Portal portal

portail contenant le curseur

FetchDirection direction

un parmi FETCH_FORWARD, FETCH_BACKWARD, FETCH_ABSOLUTE et FETCH_RELATIVE

long count

nombre de lignes à déplacer pour FETCH_FORWARD ou FETCH_BACKWARD ; nombre de lignes absolu à déplacer pour FETCH_ABSOLUTE ; ou nombre de lignes relatif à déplacer pour FETCH_RELATIVE

Valeur de retour

SPI_processed est configuré comme SPI_execute en cas de succès. SPI_tuptable est configuré à NULL car aucune ligne n'est renvoyée par cette fonction.

Notes

Voir la commande SQL FETCH pour des détails sur l'interprétation des paramètres direction et count.

Les valeurs de direction autres que FETCH_FORWARD peuvent échouer si le plan du curseur n'a pas été créé avec l'option CURSOR_OPT_SCROLL.