SQL から C へ: 文字

文字 ODBC SQL データ型の識別子は次のとおりです。

• SQL_CHAR
• SQL_VARCHAR
• SQL_LONGVARCHAR
• SQL_WCHAR
• SQL_WVARCHAR
• SQL_WLONGVARCHAR

次の表は、文字 SQL データの変換先となる ODBC C データ型を示しています。 テーブル内の列と用語の詳細については、「 SQL から C データ型へのデータの変換」を参照してください。

C 型識別子	テスト	TargetValuePtr	StrLen_or_IndPtr	SQLSTATE
SQL_C_CHAR	データ <BufferLength のバイト長 データ >のバイト長 = BufferLength	Data 切り捨てられたデータ	データの長さ (バイト単位) データの長さ (バイト単位)	該当なし 01004
SQL_C_WCHAR	データ <BufferLength の文字長 データ >の文字長 = BufferLength	Data 切り捨てられたデータ	文字単位のデータの長さ 文字単位のデータの長さ	該当なし 01004
SQL_C_STINYINT SQL_C_UTINYINT SQL_C_TINYINT SQL_C_SBIGINT SQL_C_UBIGINT SQL_C_SSHORT SQL_C_USHORT SQL_C_SHORT SQL_C_SLONG SQL_C_ULONG SQL_C_LONG SQL_C_NUMERIC	切り捨てなしで変換されたデータ [b] 小数部の桁を切り捨てて変換されたデータ[a] データを変換すると、(小数ではなく) 全体の数字が失われます[a] データが 数値リテラルではありません[b]	Data 切り捨てられたデータ 未定義。 未定義。	C データ型のバイト数 C データ型のバイト数 未定義。 未定義。	該当なし 01S07 22003 22018
SQL_C_FLOAT SQL_C_DOUBLE	データは、数値の変換先となるデータ型の範囲内です[a] データが、数値の変換先となるデータ型の範囲外である[a] データが 数値リテラルではありません[b]	Data 未定義。 未定義。	C データ型のサイズ 未定義。 未定義。	該当なし 22003 22018
SQL_C_BIT	データが 0 または 1 である データが 0 より大きく、2 未満で、1 と等しくない データが 0 より小さいか、2 以上である データが数値リテラルではありません	Data 切り捨てられたデータ 未定義。 未定義。	1[b] 1[b] 未定義。 未定義。	該当なし 01S07 22003 22018
SQL_C_BINARY	データ <のバイト長 = BufferLength データ >BufferLength のバイト長	Data 切り捨てられたデータ	データの長さ (バイト単位) データの長さ	該当なし 01004
SQL_C_TYPE_DATE	データ値は有効な 日付値です[a] データ値は有効な timestamp-value です。時間の部分は 0[a] データ値は有効な timestamp-value です。time 部分が 0 以外の場合[a],[c] データ値が有効な 日付値 または timestamp-value[a] ではありません	データ Data 切り捨てられたデータ 未定義。	6[b] 6[b] 6[b] 未定義。	該当なし 該当なし 01S07 22018
SQL_C_TYPE_TIME	データ値は有効な 時間値であり、秒の小数部の値は 0[a] です データ値は、有効な timestamp-value または有効な時刻値です。秒の小数部が 0[a],[d] データ値は有効な timestamp-value です。秒の小数部が 0 以外の [a],[d],[e] データ値が有効な 時間値 または timestamp-value[a] ではありません	データ Data 切り捨てられたデータ 未定義。	6[b] 6[b] 6[b] 未定義。	該当なし 該当なし 01S07 22018
SQL_C_TYPE_TIMESTAMP	データ値は、有効な timestamp-value または有効な時刻値です。秒の小数部が切り捨てられない [a] データ値は、有効な timestamp-value または有効な時刻値です。秒の小数部の切り捨て[a] データ値は有効な 日付値です[a] データ値は有効な 時間値です[a] データ値が有効な 日付値、 時刻値、または timestamp-value[a] ではありません	Data 切り捨てられたデータ Data[f] Data[g] 未定義。	16[b] 16[b] 16[b] 16[b] 未定義。	該当なし 01S07 該当なし 該当なし 22018
すべての C 間隔の種類	データ値は有効な 間隔値です。切り捨てなし データ値は有効な 間隔値です。1 つ以上の末尾フィールドの切り捨て データは有効な間隔です。先頭フィールドの有効桁数が失われる データ値が有効な間隔値ではありません	Data 切り捨てられたデータ 未定義。 未定義。	データの長さ (バイト単位) データの長さ (バイト単位) 未定義。 未定義。	該当なし 01S07 22015 22018

[a] この変換では BufferLength の値は無視されます。 ドライバーは、*TargetValuePtr のサイズが C データ型のサイズであると想定しています。

[b] これは、対応する C データ型のサイズです。

[c] timestamp-value の時刻部分が切り捨てられます。

[d] timestamp-value の日付部分は無視されます。

[e] タイムスタンプの秒の小数部が切り捨てられます。

[f] タイムスタンプ構造体の時刻フィールドは 0 に設定されます。

[g] タイムスタンプ構造の日付フィールドは現在の日付に設定されます。

余分なスペース

SQL 文字データが次のいずれかの型に変換される場合、先頭と末尾のスペースは無視されます。

• 日付
• numeric
• time
• timestamp
• interval C data