Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16

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 以获取错误指示)