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内の項目は有効です。)

nullsNULL の場合、SPI_execpはすべてのパラメータがNULLであるとみなします。

int count

計画が実行される行数。

戻り値

戻り値は、SPI_exec同様、あるいは、以下のいずれかです。

SPI_ERROR_ARGUMENT

planNULL あるいは、count が0未満の場合。

SPI_ERROR_PARAM

valuesNULL 、かつ、plan がパラメータ付きで準備された場合。

成功時、SPI_processedSPI_tuptableSPI_exec 同様に設定されます。

注意

準備された計画で参照されるオブジェクト(テーブル、関数、など)のいずれかがセッション中に削除された場合、その計画用のSPI_execpの結果は予測不能です。