# SPI_execute_plan ## Name SPI_execute_plan?--?執行一個`SPI_prepare`準備的語句 ## Synopsis ``` int SPI_execute_plan(SPIPlanPtr plan, Datum * values, const char * nulls, bool read_only, long count) ``` ## 描述 `SPI_execute_plan`執行一個`SPI_prepare` 或它的兄弟節點之一準備的語句。`read_only`和 `count`的含義和`SPI_execute`里面的相同。 ## 參數 `SPIPlanPtr` `plan` 預備語句（`SPI_prepare`返回的） `Datum *` `values` 一個實際的參數值的數組。必須和語句的參數個數相同。 `const char *` `nulls` 一個描述哪個參數是空的數組。必須和語句的參數個數相同。 如果`nulls`是`NULL`，那么`SPI_execute_plan` 假設沒有參數為空。否則，如果對應的參數值是非空的，那么`nulls` 數組的每一項都應該是`'?'`，或者如果對應的參數值為空，那么 `nulls`數組的每一項都是`'n'`。 （在后面這種情況下，對應的`values`項中的實際值無關緊要。） 請注意，`nulls`不是文本字符串，只是一個數組： 它不需要`'\0'`終止符。 `bool` `read_only` `true`用于只讀的執行 `long` `count` 返回的最大行數，或者沒有限制時為`0` ## 返回值 返回值和`SPI_execute`的一樣，另外還有下面幾個可能的錯誤(負值)結果： `SPI_ERROR_ARGUMENT` 如果`plan`是`NULL`或者無效， 或者`count`小于 0 `SPI_ERROR_PARAM` 如果`values`是`NULL`并且 `plan`準備了一些參數 成功時，`SPI_processed`和`SPI_tuptable` 的設置和`SPI_execute`里一樣。