PostgreSQL 8.4.1文書
前のページ | 巻戻し |  | 早送り | 次のページ

# SPI_cursor_open_with_args

## 名前

SPI_cursor_open_with_args -- 問い合わせとパラメータを使ってカーソルを設定

## 概要

    Portal SPI_cursor_open_with_args(const char *name,
                                     const char *command,
                                     int nargs, Oid *argtypes,
                                     Datum *values, const char *nulls,
                                     bool read_only, int cursorOptions)

## 説明

`SPI_cursor_open_with_args`は特定の問い合わせを実行するカーソル（内部的にはポータル）を設定します。殆んどのパラメータには、`SPI_prepare_cursor`と`SPI_cursor_open`に関連したパラメータと同じ意味を持っています。

１回限りの問い合わせ実行に対しては、後に`SPI_cursor_open`が続いた`SPI_prepare_cursor`に対し、この関数を選ぶべきです。多くの異なったパラメータを持つ同一のコマンドが実行されると、再計画対独自計画による利益のコストに依存して、どちらか一方の方法がより早くなります。

渡されたデータはカーソルのポータルに複写されるので、カーソルが存在している間は開放することができます。

## 引数

`const char * `name``

  ポータルの名前、またはシステムに名前を選択させる`NULL`

`const char * `command``

  コマンド文字列

`int `nargs``

  （`$1`、`$2`など）入力パラメータの数

`Oid * `argtypes``

  パラメータのデータ型のOIDを含む配列

`Datum * `values``

  実パラメータ値の配列

`const char * `nulls``

  どのパラメータがnullかを記述する配列

  `nulls`が`NULL`であれば、`SPI_cursor_open_with_args`はどのパラメータもnullでないと看做す

`bool `read_only``

  読み出し専用実行では`真`

`int `cursorOptions``

  カーソル位置の整数ビットマスク。ゼロの場合はデフォルトの動作

## 戻り値

カーソルを含んだポータルへのポインタ。エラーを返す慣例がないことに注意。すべてのエラーは`elog`で報告。

前のページ | ホーム | 次のページ
SPI_cursor_open | 上に戻る | SPI_cursor_find