# SPI_cursor_open_with_args ## Name SPI_cursor_open_with_args?--?使用查詢和參數設置一個游標 ## Synopsis ``` Portal SPI_cursor_open_with_args(const char *name, const char *command, int nargs, Oid *argtypes, Datum *values, const char *nulls, bool read_only, int cursorOptions) ``` ## 描述 `SPI_cursor_open_with_args`設置一個游標（內部的，一個入口）， 該游標將執行指定的查詢。大多數參數和`SPI_prepare_cursor` 和`SPI_cursor_open`的對應參數有相同的含義。 對于一次性查詢執行，跟著`SPI_cursor_open`的 `SPI_prepare_cursor`應該會偏愛這個函數。 如果相同的命令用不同的參數執行，哪種方法可能更快， 取決于重新規劃的開銷和自定義規劃的益處的比較。 傳入參數數據將被拷貝到游標的入口，所以它在游標仍然存在時可以被釋放。 ## 參數 `const char *` `name` 入口的名字，或`NULL`讓系統選擇一個名字 `const char *` `command` 命令字符串 `int` `nargs` 輸入參數的個數 (`$1`, `$2`等等) `Oid *` `argtypes` 長度`nargs`的一個數組，包括參數數據類型的OID `Datum *` `values` 長度`nargs`的一個數組，包括實際的參數值 `const char *` `nulls` 長度`nargs`的一個數組，描述哪個參數為空 如果`nulls`是`NULL`，那么`SPI_cursor_open_with_args` 假設沒有參數為空。否則，如果對應的參數值是非空的，那么`nulls` 數組的每一項都應該是`'?'`，或者如果對應的參數值為空，那么 `nulls`數組的每一項都是`'n'`。 （在后面這種情況下，對應的`values`項中的實際值無關緊要。） 請注意，`nulls`不是文本字符串，只是一個數組： 它不需要`'\0'`終止符。 `bool` `read_only` `true`用于只讀的執行 `int` `cursorOptions` 游標選項的整型位標記；零表示缺省行為 ## 返回值 指向包含游標入口的指針。請注意，這里沒有錯誤返回約定； 任何錯誤都將通過`elog`報告。