历史版本。 PostgreSQL 9.5 已结束支持。 2021-02-11. 请参阅 当前版本手册.
SPI_execp
SPI_execp — 以读/写模式执行一个语句
大纲
int SPI_execp(SPIPlanPtrplan, Datum *values, const char *nulls, longcount)
描述
SPI_execp 与
SPI_execute_plan 相同,只不过后者的
read_only 参数固定为
false。
参数
SPIPlanPtrplan预备语句(由
SPI_prepare返回)Datum *values一个实际参数值的数组。必须和语句的参数数量等长。
const char *nulls一个描述哪些参数为空值的数组。必须和语句的参数数量等长。
如果
nulls为NULL,则SPI_execp会假定没有参数为空值。否则,如果对应参数值非空值,则nulls数组中的对应项应为' ';如果对应参数值为空值,则对应项应为'n'。(后一种情况下,对应values项中的实际值无关紧要。)注意,nulls不是文本字符串,而只是一个数组,因此不需要'\0'终止符。longcount要返回的最大行数,或者用
0表示不限制
返回值
见 SPI_execute_plan。
成功时,SPI_processed 和
SPI_tuptable 的设置方式与
SPI_execute 相同。