PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

SPI_returntuple

SPI_returntuple — 准备把一个元组作为 Datum 返回

Synopsis

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)