SPI_returntuple

SPI_returntuple — 准备将元组作为 Datum 返回

摘要

HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

描述

SPI_returntuple复制上层执行器上下文中的行，以行类型Datum的形式返回。返回的指针只需通过PointerGetDatum转换为Datum，然后返回。

此函数只能在连接到 SPI 时使用。否则，它将返回 NULL，并将SPI_result设置为SPI_ERROR_UNCONNECTED。

请注意，这应用于声明为返回复合类型的函数。它不适用于触发器；使用SPI_copytuple返回触发器中修改的行。

参数

HeapTuple row

要复制的行

TupleDesc rowdesc

行的描述符（每次传递相同的描述符，以实现最有效的缓存）

返回值

HeapTupleHeader指向复制的行，或NULL（如果出错，请参见SPI_result以获取错误指示）