文字データの SQL から C への変換

C データ・タイプに変換可能な文字 SQL データ・タイプは、SQL_CHAR、SQL_VARCHAR、SQL_LONGVARCHAR および SQL_CLOB です。

次の表は、文字 SQL データから C データへの変換 に関する情報を示しています。

表 1. 文字 SQL データから C データへの変換
fCType テスト rgbValue pcbValue SQLSTATE
  • SQL_C_CHAR
  • SQL_C_WCHAR
データ長 < cbValueMax データ データ長 (バイト)1 000002
データ長 >= cbValueMax 切り捨てられたデータ データ長 (バイト) 01004
SQL_C_BINARY データ長 <= cbValueMax データ データ長 (バイト) 000002
データ長 > cbValueMax 切り捨てられたデータ データ長 (バイト) 01004
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
切り捨てられずに変換されたデータ データ データ長 (バイト) 000001
データが数値ではない 影響なし データ長 (バイト) 220053
  • SQL_C_SHORT
  • SQL_C_LONG
  • SQL_C_BIGINT
  • SQL_C_FLOAT
  • SQL_C_DOUBLE
  • SQL_C_TINYINT
  • SQL_C_BIT
切り捨てられずに変換されたデータ3 データ C データ・タイプのサイズ (バイト) 000002
変換され切り捨てられたデータ、ただし有効数字は失われていない3 データ C データ・タイプのサイズ (バイト) 01004
データ変換の結果、有効数字が失われる3 影響なし C データ・タイプのサイズ (バイト) 22003
データが数値ではない3 影響なし C データ・タイプのサイズ (バイト) 22005
SQL_C_TYPE_DATE データ値が有効な日付である3 データ 64 000002
データ値が有効な日付ではない3 影響なし 64 22008
SQL_C_TYPE_TIME データ値が有効な時刻である3 データ 64 000002
データ値が有効な時刻ではない3 影響なし 64 22008
SQL_C_TYPE_TIMESTAMP データ値が有効なタイム・スタンプである3 データ 164 000002
データ値が有効なタイム・スタンプではない3 影響なし 164 22008
SQL_C_TYPE_TIMESTAMP_EXT データ値が有効なタイム・スタンプである3 データ 204 000002
データ値が有効なタイム・スタンプではない3 影響なし 204 22008
注:
  1. SQL_C_WCHAR データ・タイプの場合は、データ長は UCS-2 ユニコード・データのバイト数です。
  2. SQLSTATE 00000 は、SQLGetDiagRec() によって戻されるのではなく、関数が SQL_SUCCESS を戻すときに示されます。
  3. cbValueMax の値はこの変換では無視されます。 ドライバーは、rgbValue のサイズは C データ・タイプのサイズであると想定します。
  4. これは、対応する C データ・タイプのサイズです。