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 もしくはrowdescNULLの場合のみNULLが返ります。