SPI_returntuple

Name

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

Synopsis

HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

描述

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

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

参数

HeapTuple row

将要被拷贝的行

TupleDesc rowdesc

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

返回值

指向拷贝出来的行的HeapTupleHeader；只有在row 或rowdesc是NULL的时候才返回NULL