SPI_prepare_cursor — 文を準備する。まだ実行は行わない
SPIPlanPtr SPI_prepare_cursor(const char *command
, intnargs
, Oid *argtypes
, intcursorOptions
)
SPI_prepare_cursor
は、プランナの「カーソルオプション」パラメータを指定できる点を除き、SPI_prepare
と同じです。
これはDeclareCursorStmt
のoptions
フィールド用にnodes/parsenodes.h
で示された値を持つビットマスクです。
SPI_prepare
では常にカーソルオプションをゼロとして扱います。
const char * command
コマンド文字列
int nargs
入力パラメータ($1
、$2
など)の数
Oid * argtypes
パラメータのデータ型のOIDを持つ配列へのポインタ
int cursorOptions
カーソルオプションの整数ビットマスク。 ゼロはデフォルトの動作を引き起こします
SPI_prepare_cursor
はSPI_prepare
と同じ戻り値の規則を持ちます。
cursorOptions
に指定できるビットには、CURSOR_OPT_SCROLL
、CURSOR_OPT_NO_SCROLL
、CURSOR_OPT_FAST_PLAN
、CURSOR_OPT_GENERIC_PLAN
、CURSOR_OPT_CUSTOM_PLAN
があります。
特にCURSOR_OPT_HOLD
は無視される点に注意してください。