# SPI_prepare_cursor ## Name SPI_prepare_cursor?--?準備一個語句但不立即執行它 ## Synopsis ``` SPIPlanPtr SPI_prepare_cursor(const char * command, int nargs, Oid * argtypes, int cursorOptions) ``` ## 描述 `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`。