Db2® ODBC アプリケーションでの相対スクロールおよび絶対スクロール

両方向スクロール・カーソルを使用する場合は、SQLFetchScroll() を呼び出して、カーソルを移動し行をフェッチします。フェッチする行の集合を行セット と言います。

SQLFetchScroll() 関数は相対スクロール (次の行への移動、前の行への移動、n 行だけ前方または後方に移動 ) および絶対スクロール (最初の行への移動、最後の行への移動、行番号 n への移動) をサポートします。 SQLFetchScroll() 呼び出しの FetchOrientation パラメーターで、スクロールのタイプを決定します。可能な値は、以下のとおりです。
  • SQL_FETCH_NEXT
  • SQL_FETCH_PRIOR
  • SQL_FETCH_FIRST
  • SQL_FETCH_LAST
  • SQL_FETCH_ABSOLUTE
  • SQL_FETCH_RELATIVE

SQL_FETCH_ABSOLUTE の場合、FetchOffset パラメーターはカーソルの移動先の行を決定します。SQL_FETCH_RELATIVE の場合、FetchOffset パラメーターは、カーソルを移動する行数を決定します。

次の図には、SQLFetchScroll() 呼び出しにさまざまな FetchOffset と FetchOrientation パラメーター値を指定した場合の結果セット内のカーソルがどのように移動するかを示します。この例では、行セット・サイズは 3 で、元のカーソル位置は、結果セットの最後から 3 行にあります。

図 1. SQLFetchScroll() 呼び出し後のカーソル移動の例
図の要約の開始この図は、5 回の SQLFetchScroll() 呼び出し後のカーソル位置の結果の例を示しています。
詳細な説明が可能

行セット全体にデータが含まれていると想定することはできません。アプリケーションは、それぞれのフェッチ後、行セットのサイズを検査して、行セットに完全な行セットが含まれているかどうか判別します。例えば、行セットを 10 に設定し、FetchOrientation 値に SQL_FETCH_ABSOLUTE および FetchOffset 値に -3 を使用して、SQLFetchScroll() 呼び出すとします。次の図に示すように、この関数呼び出しは、結果セットの終りから 3 行にカーソル位置を設定し、10 行フェッチするよう試みます。

図 2. 不完全な行セットを戻す SQLFetchScroll() 呼び出しの例
図の要約の開始この図は、SQLFetchScroll() 呼び出しの実行結果の例を示します。
詳細な説明が可能

フェッチ後、行セットの最初の 3 行のみに、意味のあるデータが含まれているので、アプリケーションではそれらの 3 行のみを使用してください。