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
)