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	資料 截斷的資料	以位元組為單位的資料長度 以位元組為單位的資料長度	n/a 01004
SQL_C_WCHAR	資料 < BufferLength 的字元長度 資料 > 字元長度 = BufferLength	資料 截斷的資料	以字元為單位的資料長度 以字元為單位的資料長度	n/a 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]	資料 截斷的資料 未定義 未定義	C 資料類型的位元組數目 C 資料類型的位元組數目 未定義 未定義	n/a 01S07 22003 22018
SQL_C_FLOAT SQL_C_DOUBLE	資料位於要轉換數位的資料類型範圍內[a] 資料超出要轉換數位的資料類型範圍[a] 資料不是 數值常值 [b]	資料 未定義 未定義	C 資料類型的大小 未定義 未定義	n/a 22003 22018
SQL_C_BIT	資料為 0 或 1 資料大於 0、小於 2 且不等於 1 資料小於 0 或大於或等於 2 資料不是 數值常值	資料 截斷的資料 未定義 未定義	1[b] 1[b] 未定義 未定義	n/a 01S07 22003 22018
SQL_C_BINARY	位元組長度的資料 < = BufferLength 資料 > BufferLength 的位元組長度	資料 截斷的資料	以位元組為單位的資料長度 資料長度	n/a 01004
SQL_C_TYPE_DATE	資料值是有效的 date-value [a] 資料值是有效的 時間戳記值 ;時間部分為零[a] 資料值是有效的 時間戳記值 ;時間部分為非零[a]，[c] 資料值不是有效的 date-value 或 timestamp-value [a]	資料 資料 截斷的資料 未定義	6[b] 6[b] 6[b] 未定義	n/a n/a 01S07 22018
SQL_C_TYPE_TIME	資料值是有效的 時間值，而小數秒值為 0 [a] 資料值是有效的 時間戳記值或有效的時間值 ;小數秒部分為零[a]，[d] 資料值是有效的 timestamp-value ;小數秒部分為 nonzero[a]，[d]，[e] 資料值不是有效的 時間值 或 timestamp-value [a]	資料 資料 截斷的資料 未定義	6[b] 6[b] 6[b] 未定義	n/a n/a 01S07 22018
SQL_C_TYPE_TIMESTAMP	資料值是有效的 時間戳記值或有效的時間值 ;小數秒部分未截斷[a] 資料值是有效的 時間戳記值或有效的時間值 ;小數秒部分已截斷[a] 資料值是有效的 date-value [a] 資料值是有效的 時間值 [a] 資料值不是有效的 date-value 、 time-value 或 timestamp-value [a]	資料 截斷的資料 Data[f] Data[g] 未定義	16[b] 16[b] 16[b] 16[b] 未定義	n/a 01S07 n/a n/a 22018
所有 C 間隔類型	資料值是有效的 間隔值 ;沒有截斷 資料值是有效的 間隔值 ;截斷一或多個尾端欄位 資料是有效的間隔;前置欄位顯著精確度遺失 資料值不是有效的間隔值	資料 截斷的資料 未定義 未定義	以位元組為單位的資料長度 以位元組為單位的資料長度 未定義 未定義	n/a 01S07 22015 22018

[a] 這個轉換會忽略 BufferLength 的值 。 驅動程式假設 * TargetValuePtr 的大小是 C 資料類型的大小。

[b] 這是對應 C 資料類型的大小。

[c] 時間戳記值 的時間部分 會截斷。

[d] 會忽略 timestamp-value 的 日期部分。

[e] 時間戳記的小數秒部分會截斷。

[f] 時間戳記結構的時間欄位會設定為零。

[g] 時間戳記結構的日期欄位會設定為目前的日期。

額外空間

當 SQL 字元資料轉換成下列任何類型時，會忽略前置和尾端空格：

• date
• numeric
• time
• timestamp
• interval C 資料