結果セットを配列の中に取り出す

アプリケーションは、照会ステートメントを実行し、 その照会で生成された結果セットから行をフェッチすることができます。

複数行をフェッチするには、一般には、SQLBindCol() を用いてアプリケーション変数を結果セットの複数列にバインドします。その後、各行を個別にフェッチして、これらの複数アプリケーション変数に入れます。 結果セットから複数の行をアプリケーションで保管する場合は、各フェッチの後に 追加の操作を続けることができます。さらにデータをフェッチする前に、以下のいずれかの操作によって、 前にフェッチした値をアプリケーションで保管することができます。
  • フェッチされた値をコピーして、結果セットにバインドされていないアプリケーション変数に入れる。
  • SQLBindCol() 関数の新しいセットを呼び出して、新規のアプリケーション変数を次のフェッチに割り当てる。
上記のいずれの操作も行わない場合は、直前にフェッチした値は、フェッチするたびに 置き換えられてしまいます。

別の方法としては、複数の行のデータ (行セットと呼ばれます) を同時に配列の中に 取り出すことができます。 この方式では、余分なデータ・コピーまたは SQLBindCol() 呼び出しのオーバーヘッドを除去できます。SQLBindCol() は、アプリケーション変数の配列をバインドできます。 デフォルトでは、SQLBindCol() は行を列方向にバインドします。すなわち、 このタイプのバインドは、直前のトピックで 説明しているように、SQLBindParameter() を使用して入力パラメーター値の配列をバインドするのと似ています。また、データを行方向にバインドして、データを配列の中に取り出すこともできます。