SPI_getvalue

Name

SPI_getvalue -- 指定された属性の文字列値を返します。

Synopsis

SPI_getvalue(tuple, tupdesc, fnumber)

入力

HeapTuple tuple

対象とする入力タプルです。

TupleDesc tupdesc

入力タプル記述です。

int fnumber

属性番号です。

出力

char *

属性値、もしくは、以下の場合はNULLです。

属性が NULL の場合。
fnumber が範囲外の場合 (SPI_result は SPI_ERROR_NOATTRIBUTE に設定されます)。
出力関数が使用不能の場合 (SPI_result は SPI_ERROR_NOOUTFUNC に設定されます)。

説明

SPI_getvalue は、指定した属性値の外部 (文字列) 表現を返します。

使用方法

属性番号は1から始まります。

アルゴリズム

結果は palloc された文字列として返されます。(この文字列を片付ける時は pfree() を使用して解放して下さい。