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