SPI_returntuple

SPI_returntuple —准备返回一个 Tuples 作为基准

Synopsis

HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

Description

SPI_returntuple在上层执行程序上下文中复制行，并以行类型Datum的形式返回。返回的指针只需在返回之前通过PointerGetDatum转换为Datum即可。

仅当连接到 SPI 时才能使用此功能。否则，它返回 NULL 并将SPI_result设置为SPI_ERROR_UNCONNECTED。

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

Arguments

• HeapTuple row

  • 要复制的行

• TupleDesc rowdesc

  • 行的 Descriptors(最有效的缓存每次都传递相同的 Descriptors)

Return Value

HeapTupleHeader指向复制的行，或NULL出现错误(有关错误指示，请参见SPI_result)