sesam_seek_row
説明
bool sesam_seek_row ( string result_id, int whence, int [offset])result_id は有効な結果IDです。(select 型のクエリで、かつ、sesam_query()をコール した際に"スクロール可能な"カーソルが要求された場合のみ)
whence は、この後の"スクロール型"カーソル の取得処理で使用されるスクロールの型を指定するスクロール型のグロー バルなデフォルト値を設定し、次のような定義済みの定数を設定します。
表 1"whence" パラメータの有効な値
| 値 | 定数 | 意味 |
|---|---|---|
| 0 | SESAM_SEEK_NEXT | 連続的に読み込む |
| 1 | SESAM_SEEK_PRIOR | 連続的に後向きに読む |
| 1 | SESAM_SEEK_PRIOR | 連続的に後向きに読み込む (取得後、内部デフォルト値は 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は、オプションのパラメータであり、 whenceが SESAM_SEEK_RELATIVEまたは SESAM_SEEK_ABSOLUTE のどちらかである場合にのみ 評価されます(また必要とされます)。