result_id は有効な結果 ID です (select 型のクエリで、かつ、sesam_query() を コールした際に"スクロール可能な"カーソルが要求された場合のみ)。
whence は、この後の"スクロール型"カーソルの 取得処理で使用されるスクロールの型を指定する、スクロール型の グローバルなデフォルト値を設定し、次のような定義済みの定数を 設定します。
表 1. "whence" パラメータの有効な値
値 | 定数 | 意味 |
---|---|---|
0 | SESAM_SEEK_NEXT | 連続的に読み込む |
1 | SESAM_SEEK_PRIOR | 連続的に後向きに読む |
2 | SESAM_SEEK_FIRST | 最初のレコードに移動する (取得後、デフォルト値は SESAM_SEEK_NEXT に設定されます) |
3 | SESAM_SEEK_LAST | 最後のレコードに移動する (取得後、デフォルト値は SESAM_SEEK_PRIOR に設定されます) |
4 | SESAM_SEEK_ABSOLUTE | offset (0 が先頭。取得後、 内部デフォルト値は SESAM_SEEK_ABSOLUTE に設定されます。内部のオフセット値は、自動的に増加します) で指定した絶対レコード番号に移動します。 |
5 | SESAM_SEEK_RELATIVE | カレントのスクロール位置に対して相対位置に移動。ただし、 offset は正または負の値を指定可能です (これは、以降の取得の際のデフォルトの "offset" も設定します)。 |
offset は、オプションのパラメータであり、 whence が SESAM_SEEK_RELATIVE または SESAM_SEEK_ABSOLUTE のどちらかである場合にのみ 評価されます (また必要とされます)。