SPI_execp
名前
SPI_execp --
SPI_prepareで準備された計画を実行します。
概要
int SPI_execp(void * plan, Datum * values, const char * nulls, int count)
説明
SPI_execp は、SPI_prepareで準備された計画を実行します。
tcountは、SPI_exec と同様の解釈がなされます。
引数
- void * plan
(SPI_prepareで返される)実行計画。
- Datum *values
実パラメータ値。
- const char * nulls
どのパラメータがNULLであるかを示す配列。
nはNULL値を表します。(values内の項目は無視されます。)
空白は非NULLの値を表します。(values内の項目は有効です。)
nulls が NULL の場合、SPI_execpはすべてのパラメータがNULLであるとみなします。
- int count
計画が実行される行数。
戻り値
戻り値は、SPI_exec同様、あるいは、以下のいずれかです。
- SPI_ERROR_ARGUMENT
plan が NULL あるいは、count が0未満の場合。
- SPI_ERROR_PARAM
values が NULL 、かつ、plan がパラメータ付きで準備された場合。
成功時、SPI_processed とSPI_tuptableが SPI_exec 同様に設定されます。
注意
準備された計画で参照されるオブジェクト(テーブル、関数、など)のいずれかがセッション中に削除された場合、その計画用のSPI_execpの結果は予測不能です。