SPI_saveplan — 保存一个预备语句
SPIPlanPtr SPI_saveplan(SPIPlanPtr plan
)
SPI_saveplan
把一个被传入的语句(由
SPI_prepare
准备好)复制到不会被
SPI_finish
或者事务管理器释放的内存中。
这让你能够在当前会话的后续C函数调用中重用预备语句。
SPIPlanPtr plan
要保存的预备语句
要被复制的语句的指针;如果没有成功则返回NULL
。
错误时,SPI_result
会被这样设置:
SPI_ERROR_ARGUMENT
如果plan
为NULL
或无效
SPI_ERROR_UNCONNECTED
如果从一个未连接的C函数调用
原始的被传入的语句不会被释放,因此你可能希望在其上执行
SPI_freeplan
以避免在
SPI_finish
之前发生内存泄露。
在大部分情况下,SPI_keepplan
更适合于
执行这种功能,因为它极大程度上达到了同样的结果而无需物理地
复制该预备语句的数据结构。