SQL から C へのデータ変換

SQL データ・タイプから C データ・タイプに変換するには、引数 fCType、cbValueMax、rgbValue、および pcbValue を理解しておく必要があります。各変換の結果に対して SQLSTATE が戻されます。

それぞれの SQL データ変換タイプごとに、表に変換情報が示されています。 これらの表でそれぞれの欄では、以下の情報をリストしています。
  • 表の最初の欄は、SQLBindCol() および SQLGetData() の引数 fCType の有効な入力値を示しています。
  • 2 番目の欄では、ドライバーが、データを変換できるかどうかを判別するために行うテスト の結果を示しています。このテストでは、SQLBindCol() または SQLGetData() で指定された引数 cbValueMax がよく使用されます。
  • 3 番目と 4 番目の欄では、ドライバーがデータ変換を試みた後の、SQLBindCol() または SQLGetData() で指定された引数 rgbValue および pcbValue の 値を (それぞれの結果ごとに) 示しています。
  • 最後の欄では、SQLFetch()、SQLExtendedFetch()、または SQLGetData() によって、 それぞれの結果ごとに戻される SQLSTATE を示しています。

この表では、ある特定の SQL データ・タイプについて、ODBC が有効であると定義している変換を 示しています。

ある特定の SQL データ・タイプについて、表に示されていない値が SQLBindCol() または SQLGetData() の引数 fCType に含まれている場合、SQLFetch() または SQLGetData() は 、SQLSTATE 07006 (データ・タイプ属性制約違反) を戻します。

表には示されていてもドライバーがサポートしていない変換を指定した値が 引数 fCType に含まれている場合、SQLFetch() または SQLGetData() は 、SQLSTATE HYC00 (ドライバーが使用不可能) を戻します。

表には示されていませんが、SQL データ値が NULL の場合は、引数 pcbValue に は SQL_NULL_DATA が入ります。 複数の呼び出しを行ってデータを取り出す際の pcbValue の使い方の 説明については、SQLGetData() を参照してください。

SQL データを文字 C データに変換する場合、pcbValue に 戻される文字カウントは、NUL 終了文字を含んでいません。 rgbValue が NULL ポインターの 場合、SQLBindCol() または SQLGetData() は 、SQLSTATE HY009 (引数値が無効) を戻します。

表では、次の用語が使われています。
データ長
指定された C データ・タイプに変換後のデータのバイト単位の全長 (データがストリングに 変換された場合の NUL 終了文字を除く)。 これは、アプリケーションに戻される前にデータが 切り捨てられる場合にも当てはまります。
有効数字
負符号 (必要な場合) と小数点の左側の数字。
表示サイズ
文字形式でデータを表示するのに必要なバイトの合計数。