SPI_returntuple — 准备将元组作为 Datum 返回
HeapTupleHeader SPI_returntuple(HeapTuplerow
, TupleDescrowdesc
)
SPI_returntuple
复制上层执行器上下文中的行,以行类型 Datum
的形式返回。返回的指针只需通过 PointerGetDatum
转换为 Datum
,然后返回。
此函数只能在连接到 SPI 时使用。否则,它将返回 NULL,并将 SPI_result
设置为 SPI_ERROR_UNCONNECTED
。
请注意,这应用于声明为返回复合类型的函数。它不适用于触发器;使用 SPI_copytuple
返回触发器中修改的行。
HeapTuple row
要复制的行
TupleDesc rowdesc
行的描述符(每次传递相同的描述符,以实现最有效的缓存)
HeapTupleHeader
指向复制的行,或 NULL
(如果出错,请参见 SPI_result
以获取错误指示)