SPI_returntuple

Name

SPI_returntuple -- 准备把一个元组当作 Datum 返回

Synopsis

HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

描述

SPI_returntuple 在上层执行者环境里制作一个行的拷贝, 并且把它以行类型 Datum 的形式返回。所返回的指针在返回之前只需要用 PointerGetDatum 转换成 Datum

请注意这个函数应该只用于那些声明为返回复合类型的函数。它不用于触发器; 用 SPI_copytuple 在触发器中返回一个修改过的行。

参数

TupleDesc tupdesc

行的描述符(每次都传递同样的描述符可以获取最高缓冲效率)

返回值

指向拷贝出来的行的 HeapTupleHeader;只有在 row 或者 rowdescNULL 的时候才返回 NULL