SPI_returntuple
名前
SPI_returntuple -- Datumとしてタプルを返す準備をします。
概要
HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)
説明
SPI_returntupleは上位エクゼキュータコンテキスト内に行の複製を作成し、それを行型のDatum形式で返します。
返されるポインタは、返す前にPointerGetDatumを使用してDatumに変換することのみが必要です。
この関数は複合型を返すものと宣言された関数に対して使用しなければなりません。
トリガでは使用されません。
トリガで変更された行を返すにはSPI_copytupleを使用してください。
引数
- HeapTuple row
複製される行です。
- TupleDesc rowdesc
行の記述子です。
(最も効率的にキャッシュを行えるように毎回同一の記述子を渡してください。)
戻り値
複製された行を指し示すHeapTupleHeaderです。
row もしくはrowdescがNULLの場合のみNULLが返ります。