sesam_seek_row

(PHP 3 CVS only)

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 のどちらかである場合にのみ 評価されます(また必要とされます)。