SPI_execute_plan — 执行由 SPI_prepare 准备的语句
int SPI_execute_plan(SPIPlanPtrplan, Datum *values, const char *nulls, boolread_only, longcount)
SPI_execute_plan 执行由 SPI_prepare 或其同类函数准备的语句。 read_only 和 count 的解释与 SPI_execute 中的相同。
SPIPlanPtr plan已准备好的语句(由 SPI_prepare 返回)
Datum * values实际参数值的数组。长度必须与语句的参数数量相同。
const char * nulls描述哪些参数为 NULL 的数组。长度必须与语句的参数数量相同。
如果 nulls 是 NULL,则 SPI_execute_plan 假定没有参数为 NULL。否则,nulls 数组的每个条目都应为 ' '(如果相应的参数值非 NULL)或 'n'(如果相应的参数值为 NULL)。 (后一种情况,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 中的相同。
如果您在本应文档中发现任何不正确、与您对特定功能的体验不符或需要进一步说明的内容,请使用 此表单 报告文档问题。