SPI_returntuple — Datumとしてタプルを返す準備をする
HeapTupleHeader SPI_returntuple(HeapTuplerow
, TupleDescrowdesc
)
SPI_returntuple
は上位エクゼキュータコンテキスト内に行の複製を作成し、それを行型のDatum
形式で返します。
返されるポインタは、返す前にPointerGetDatum
を使用してDatum
に変換することのみが必要です。
この関数はSPIに接続されている間にのみ使うことができます。
それ以外の場合はNULLを返し、SPI_result
をSPI_ERROR_UNCONNECTED
にセットします。
この関数は複合型を返すものと宣言された関数に対して使用しなければなりません。
トリガでは使用されません。
トリガで変更された行を返すにはSPI_copytuple
を使用してください。
HeapTuple row
コピーされる行
TupleDesc rowdesc
行の記述子(最も効率的にキャッシュを行えるように毎回同一の記述子を渡してください)
コピーされた行を指し示すHeapTupleHeader
、あるいはエラー時はNULL
です。
(エラーの表示についてはSPI_result
を参照してください)