C から SQL へ: 文字
文字 ODBC C データ型の識別子は次のとおりです。
SQL_C_CHAR
SQL_C_WCHAR
次の表は、C 文字データの変換先となる ODBC SQL データ型を示しています。 テーブル内の列と用語の詳細については、「 C から SQL データ型へのデータの変換」を参照してください。
Note
文字 C データを Unicode SQL データに変換する場合、Unicode データの長さは偶数である必要があります。
| SQL 型識別子 | テスト | SQLSTATE |
|---|---|---|
| SQL_CHAR SQL_VARCHAR SQL_LONGVARCHAR |
データ <のバイト長 = 列の長さ。 データ > のバイト長 列の長さ。 |
該当なし 22001 |
| SQL_WCHAR SQL_WVARCHAR SQL_WLONGVARCHAR |
データ <の文字長 = 列の長さ。 データ > の文字長 列の長さ。 |
該当なし 22001 |
| SQL_DECIMAL SQL_NUMERIC SQL_TINYINT SQL_SMALLINT SQL_INTEGER SQL_BIGINT |
切り捨てなしで変換されたデータ 小数部の桁を切り捨てて変換されたデータ[e] データを変換すると、(小数ではなく) 全体の数字が失われます[e] データ値が数値リテラルではありません |
該当なし 22001 22001 22018 |
| SQL_REAL SQL_FLOAT SQL_DOUBLE |
データが、数値の変換先のデータ型の範囲内にある データが、数値の変換先となるデータ型の範囲外である データ値が数値リテラルではありません |
該当なし 22003 22018 |
| SQL_BIT | データが 0 または 1 である データが 0 より大きく、2 未満で、1 と等しくない データが 0 より小さいか、2 以上である データが数値リテラルではありません |
該当なし 22001 22003 22018 |
| SQL_BINARY SQL_VARBINARY SQL_LONGVARBINARY |
(データのバイト長) / 2 <= 列バイト長 (データのバイト長) / 2 > 列のバイト長 データ値が 16 進数の値ではありません |
該当なし 22001 22018 |
| SQL_TYPE_DATE | データ値は有効な ODBC-date-literal です データ値は、有効な ODBC-timestamp-literal です。時間の部分は 0 です データ値は、有効な ODBC-timestamp-literal です。time 部分が 0 以外である[a] データ値が有効な ODBC-date-literal または ODBC-timestamp-literal ではありません |
該当なし 該当なし 22008 22018 |
| SQL_TYPE_TIME | データ値は有効な ODBC-time-literal です データ値は、有効な ODBC-timestamp-literal です。秒の小数部が 0[b] データ値は、有効な ODBC-timestamp-literal です。秒の小数部が 0 以外である [b] データ値が有効な ODBC-time-literal または ODBC-timestamp-literal ではありません |
該当なし 該当なし 22008 22018 |
| SQL_TYPE_TIMESTAMP | データ値は、有効な ODBC-timestamp-literal です。秒の小数部が切り捨てられない データ値は、有効な ODBC-timestamp-literal です。秒の小数部の切り捨て データ値は有効な ODBC-date-literal[c] です データ値は有効な ODBC-time-literal[d] です データ値が有効な ODBC-date-literal、ODBC-time-literal、または ODBC-timestamp-literal ではありません |
該当なし 22008 該当なし 該当なし 22018 |
| すべての SQL 間隔の種類 | データ値は有効な 間隔値です。切り捨ては行われません データ値は有効な 間隔値です。いずれかのフィールドの値が切り捨てられます データ値が有効な間隔リテラルではありません |
該当なし 22015 22018 |
[a] タイムスタンプの時刻部分が切り捨てられます。
[b] タイムスタンプの日付部分は無視されます。
[c] タイムスタンプの時刻部分は 0 に設定されます。
[d] タイムスタンプの日付部分は現在の日付に設定されます。
[e] ドライバー/データ ソースは、変換を実行する前に、文字列全体が受信されるまで (文字データが SQLPutData への呼び出しによって一部ずつ送信される場合でも) 実質的に待機します。
文字 C データが数値、日付、時刻、またはタイムスタンプ SQL データに変換される場合、先頭と末尾のブランクは無視されます。
文字 C データをバイナリ SQL データに変換すると、2 バイトの文字データはそれぞれ 1 バイト (8 ビット) のバイナリ データに変換されます。 文字データの各 2 バイトは、16 進数形式で数値を表します。 たとえば、"01" はバイナリ 00000001に変換され、"FF" はバイナリ 11111111に変換されます。
ドライバーは常に 16 進数のペアを個々のバイトに変換し、null 終了バイトを無視します。 このため、文字列の長さが奇数の場合、文字列の最後のバイト (null 終端バイトがある場合は除く) は変換されません。
Note
アプリケーション開発者は、文字 C データをバイナリ SQL データ型にバインドすることはお勧めしません。 通常、この変換は非効率的で低速です。