要在程序和数据库服务器间传送信息,每个数据都必须有一个数据类型。嵌入式 SQL 数据类型常量以 DT_ 为前缀,并且可以在 sqldef.h 头文件中找到。您可以创建任何一种受支持类型的主机变量。您还可以在 SQLDA 结构中使用这些类型向数据库中传入和从中传出数据。
可以使用 sqlca.h 中列出的 DECL_ 宏定义这些数据类型的变量。例如,可使用 DECL_BIGINT 来声明保存 BIGINT 值的变量。
以下数据类型受嵌入式 SQL 编程接口的支持:
typedef struct TYPE_DECIMAL { char array[1]; } TYPE_DECIMAL; |
DT_STRING 在 CHAR 字符集中以空值终止的字符串。如果数据库是使用填补空白的字符串进行的初始化,则该字符串便是用空白填补的。
DT_NSTRING 在 NCHAR 字符集中以空值终止的字符串。如果数据库是使用填补空白的字符串进行的初始化,则该字符串便是用空白填补的。
DT_FIXCHAR 在 CHAR 字符集中填补空白的定长字符串。最大长度为 32767(以字节为单位)。该数据不以空值终止。
DT_NFIXCHAR 在 NCHAR 字符集中填补空白的定长字符串。最大长度为 32767(以字节为单位)。该数据不以空值终止。
DT_VARCHAR 在 CHAR 字符集中具有双字节长度字段的变长字符串。最大长度为 32765 个字节。发送数据时,必须设置长度字段。读取数据时,数据库服务器设置长度字段。该数据不是以空值终止或以空白填补的。
typedef struct VARCHAR { a_sql_ulen len; char array[1]; } VARCHAR; |
DT_NVARCHAR 在 NCHAR 字符集中具有双字节长度字段的变长字符串。最大长度为 32765 个字节。发送数据时,必须设置长度字段。读取数据时,数据库服务器设置长度字段。该数据不是以空值终止或以空白填补的。
typedef struct NVARCHAR { a_sql_ulen len; char array[1]; } NVARCHAR; |
DT_LONGVARCHAR 在 CHAR 字符集中长变长字符串。
typedef struct LONGVARCHAR { a_sql_uint32 array_len; /* number of allocated bytes in array */ a_sql_uint32 stored_len; /* number of bytes stored in array * (never larger than array_len) */ a_sql_uint32 untrunc_len;/* number of bytes in untruncated expression * (may be larger than array_len) */ char array[1]; /* the data */ } LONGVARCHAR, LONGNVARCHAR, LONGBINARY; |
LONGVARCHAR 结构可用于大于 32767 个字节的数据。对于较大的数据,可以一次全部读取,也可以使用 GET DATA 语句逐段读取。对于较大的数据,可以一次就全部提供给服务器,也可以通过使用 SET 语句附加到数据库变量中来逐段提供。该数据不是以空值终止或以空白填补的。
DT_LONGNVARCHAR 在 NCHAR 字符集中长变长字符串。该宏定义一个如下结构:
typedef struct LONGVARCHAR { a_sql_uint32 array_len; /* number of allocated bytes in array */ a_sql_uint32 stored_len; /* number of bytes stored in array * (never larger than array_len) */ a_sql_uint32 untrunc_len;/* number of bytes in untruncated expression * (may be larger than array_len) */ char array[1]; /* the data */ } LONGVARCHAR, LONGNVARCHAR, LONGBINARY; |
LONGNVARCHAR 结构可用于大于 32767 个字节的数据。对于较大的数据,可以一次全部读取,也可以使用 GET DATA 语句逐段读取。对于较大的数据,可以一次就全部提供给服务器,也可以通过使用 SET 语句附加到数据库变量中来逐段提供。该数据不是以空值终止或以空白填补的。
DT_BINARY 具有双字节长度字段的变长二进制数据。最大长度为 32765 个字节。在向数据库服务器提供信息时,您必须设置长度字段。在从数据库服务器读取信息时,服务器设置长度字段。
typedef struct BINARY { a_sql_ulen len; char array[1]; } BINARY; |
DT_LONGBINARY 长二进制数据。该宏定义一个如下结构:
typedef struct LONGVARCHAR { a_sql_uint32 array_len; /* number of allocated bytes in array */ a_sql_uint32 stored_len; /* number of bytes stored in array * (never larger than array_len) */ a_sql_uint32 untrunc_len;/* number of bytes in untruncated expression * (may be larger than array_len) */ char array[1]; /* the data */ } LONGVARCHAR, LONGNVARCHAR, LONGBINARY; |
LONGBINARY 结构可用于大于 32767 个字节的数据。对于较大的数据,可以一次全部读取,也可以使用 GET DATA 语句逐段读取。对于较大的数据,可以一次就全部提供给服务器,也可以通过使用 SET 语句附加到数据库变量中来逐段提供。
DT_TIMESTAMP_STRUCT SQLDATETIME 结构,对于时间戳的每一部分都有一个字段。
typedef struct sqldatetime { unsigned short year; /* for example 1999 */ unsigned char month; /* 0-11 */ unsigned char day_of_week; /* 0-6 0=Sunday */ unsigned short day_of_year; /* 0-365 */ unsigned char day; /* 1-31 */ unsigned char hour; /* 0-23 */ unsigned char minute; /* 0-59 */ unsigned char second; /* 0-59 */ unsigned long microsecond; /* 0-999999 */ } SQLDATETIME; |
SQLDATETIME 结构可用于检索 DATE、TIME 和 TIMESTAMP 类型(或者可转换为这些类型之一的任意类型)的字段。应用程序常常具有它们自己的格式和日期操作代码。在该结构中读取数据可为操作该数据提供更多方便。也可以使用任何字符类型来读取和更新 DATE、TIME 和 TIMESTAMP 字段。
如果您使用 SQLDATETIME 结构将日期、时间或时间戳输入到数据库中,则会忽略 day_of_year 和 day_of_week 成员。
DT_VARIABLE 以空值终止的字符串。字符串必须是 SQL 变量的名称,数据库服务器使用该变量的值。此数据类型仅用于为数据库服务器提供数据。在从数据库服务器读取数据时,不能使用它。
这些结构在 sqlca.h 文件中定义。由于 VARCHAR、NVARCHAR、BINARY、DECIMAL 和 LONG 数据类型包含一个单字符数组,因此,它们对于声明主机变量没有帮助。但是,它们对于动态分配变量或强制转换其它变量的类型十分有用。
![]() |
使用DocCommentXchange讨论此页。
|
版权 © 2013, SAP 股份公司或其关联公司. - SAP Sybase SQL Anywhere 16.0 |