SPI_prepare_extended — 文を準備する。文の実行はまだ行わない
SPIPlanPtr SPI_prepare_extended(const char *command, const SPIPrepareOptions *options)
SPI_prepare_extendedは指定したコマンド用の準備済み文を作成し、それを返します。しかし、そのコマンドは実行しません。
この関数は、呼び出し元が、問い合わせの解析や計画のその他の面だけでなく、外部のパラメータ参照の解析も制御するオプションを指定できる追加機能のあるSPI_prepareと等価です。
const char * commandコマンド文字列
const SPIPrepareOptions * optionsオプションの引数を含む構造体
呼び出し元は、必ずoptions構造体全体をゼロクリアしてから、設定したいフィールドを埋めるべきです。
構造体に将来追加されるフィールドは、ゼロであれば後方互換性があるように振る舞うよう定義されますので、これはコードの将来の互換性を確実にします。
現在利用可能なoptionsフィールドは以下の通りです。
ParserSetupHook parserSetupパーサフック設定関数
void * parserSetupArg
parserSetupに渡される引数
RawParseMode parseMode
raw解析のモード。
RAW_PARSE_DEFAULT(ゼロ)はデフォルトの振舞いになります
int cursorOptionsカーソルオプションの整数ビットマスク。ゼロはデフォルトの振舞いになります
SPI_prepare_extendedはSPI_prepareと同じ戻り値の規則を持ちます。