ESQL-C的数据类型及转换

ESQL/C的数据类型及转换



一、
1、SQL与C数据类型的对应
简单类型
SQL C
CHAR（n） char(n+1)
CHARCTER（n） char *
SMALLINT short int
INTERGER
INT long int
SMALLFLOAT
REAL float
FLOAT
DOUBLE PRECISION double
SERIAL long int
DATE long int
复杂类型
SQL C
DECIMAL
DEC NUMERIC dec_t or struct decimal
MONEY dec_t or struct decimal
DATETIME dtime_t or struct dtime
INREVER intrvl_t or struct intrvl
VARCHAR varchar or string

2、数据类型转换

转换类型 转换后
FLOAT DECIMAL（16）
SMALLFLOAT DECIMAL（8）
INTERGER DECIMAL（10，0）
SAMLLINT DECIMAL（5，0）

decimal(M,N) 表示最大数字为M位，其中小数点后N位。


二、数据类型的转换函数
（一）有关CHAR类型的函数
1、以空值结尾的串的操作函数
rdownshift(char *s) 把一个字符串中的所有字母转换成小写形式。
rupshift(char *s) 把一个字符串中的所有字母转换成大写形式。
stcat(char *s, char *dest) 把一个字符串同另一个字符串相连接。
stcmpr(char *s1, char *s2) 比较两个字符串。
strcpy(char *from, char *to) 把一个字符串拷贝到另一个字符串。
stleng(char *string) 统计字符串的长度。

2、定长串的操作函数
bycmpr(char byte1, byte2, rpt len) 比较两组连续的字节内存块。
bycopy(char *from, char *to, int len) 把一块内存的内容拷贝到另一块内存。
byfill(char *to, int len, char ch) 用字符填充指定的内存块。
byleng(char from, int count) 统计有效字符的数目。有效字符是指字符串去除了末尾空格所剩的字符。

3、字符串操作函数
ldchar(char *from, int num, char *to) 拷贝定长串到空值结尾的串。
stchar(char *from, char *to, int num) 拷贝空值结尾的串到定长串。

4、字符串函数简单数值转换
rstod(char *str, double *dblval) 把以空值结束的字符串转换成C的double型
rstoi(char *str, int *intval) 把以空值结束的字符串转换成C的int类型。
rstol(char *str, long *lngval) 把以空值结束的字符串转换成C的long类型。


（二）DATE类型的函数
1、创建内部日期
rdefmtdate(long *jdate, char *frmt char *str) 将指定格式的字符串转换为内部格式日期类型。（str字符串和fmt必须按月、日、年的同一顺序）
返回代码：
0操作成功。
-1204在str参数中有非法的月份。
-1206在str参数中有非法的日期。
-1209由于str中没有包含年、月、日各部分间的定界符，str的长度必须准确定义为6或8个字节长。
-1212fmt中没有包含年、月、日部分。
fmt和str的有效组合
fmt str
“mmddyy” “DEC 25th 1997”
“mmm.dd.yyyy” “dec 25 1997”
“mmm.dd.yyyy” “DEC-25-1997”
“mm

m.dd.yyyy” “12251997”
“mmm.dd.yyyy” “12/25/1997”
“yy/mm/dd” “97/12/25”
“yy/mm/dd” “1997,December, 25th“
“yy/mm/dd” “In the year 1997, the month of December, its 25th day”
“dd-mm-yy” “This 25th day of December, 1997”
rmdyjul(short mdy[3], long *jdate) 用三个短整数生成一个内部日期这三个整数是有关年、月、日的数字值。（年必须以完整的形式表达）
返回代码：
0操作成功。
-1204在mdy[2]中有非法年份。
-1205在mdy[1]中有非法月份。
-1206在mdy[0]中有非法日期。

rstrdate(char *str, long *jdate) 将一个字符串日期转换成一内部格式的日期。
rtoday(long *jdate) 从系统日期创建一个内部日期值。

2、从内部日期转换成其他类型
rfmtdate(long jdate, char *fmt, char *str) 将内部格式的日期类型值转换为格式化的字符串。
返回代码：
0操作成功。
-1210内部日期不能被转换成月-日-年格式。
-1211程序存储溢出，即存储分配错误。

rjulmdy(long jdate, short mdy[3]) 从一个内部日期生成一个含有3个短整数的数组对应内部日期的月、日、年。

rdatestr(long jdate, char *str) 从一个内部日期值创建缺省的日期字符串。

rdayofweek(long jdate) 给定一内部格式表示的日期，此函数返回所对应的星期中的某一天。

rleapyear(int year) 用来判断给定的年份是否为闰年。
返回值：
TRUE（1） 是闰年
FALSE（0） 不是闰年


（三）简单数值类型的格式化函数
rfmtdouble(double dbval, char *fmt, char *str) 将双精度格式化为指定的模板格式。
rfmtlong(double longval, char *fmt, char *str) 将长整型值格式化为指定的模板格式。
可以构成格式模板串的字符：
*以星号代替空格。
&以0代替空格。
#代表一个数字或空格的位置。
<左调整，显示一个逗号，仅当左边有数字时才显示。
.显示一个小数点，一个格式模板串只能有一个小数点。
-显示负号，当数字为负的时候显示。
+显示正号，当数字为正的时候显示。
(显示一个负号，同（一起显示负值。
)显示一个负号，同）一起显示负值。
$显示美元符号。


（四）处理空值的数值类型函数
risnull(int type, char *cvar) 检查C变量是否为空值。
rsetnull(int type, char *cvar) 给C变量置空值。

（五）其他函数
typalign(int pos, int type) 返回一具有指定数据类型变量的下一个位置。
rtypmsize(int sqltype, int sqllen) 返回你必须分配在存储单元中的指定的C或RDSQLD的字节数。
rtyname(int sqltype) 返回一包含指定RDSQL类型名的以空结尾的串。
rtypwidth(int sqltype, intsqllen) 返回一具有RDSQL类型的值转换为一字符类型时避免截取所需的最小字符数。


ESQL/C数

据类型的进一步说明

一、DECIMAL数据类型的使用
1、DECIMAL函数——把C的数据类型转换为DECIMAL值
deccvasc(char *from, int len, dec_t *to) 把ASCII字符串转换成DECIMAL值。
返回值：
0转换成功
-1200数字太大，上溢。
-1201数字太小，下溢。
-1213存在非数值字符。
-1216存在错误指数。
注意事项：
（1）字符串的前导空格被忽略。
（2）字符串可以有前导符号“+”或“-”。
（3）字符串可以包含e或E的指数形式，指数前可带符号“+”或“-”。

deccvint(int from, dec_t *to) 把C的整数转化成DECIMAL值。
deccvlong(long from, dec_t *to) 把C的长整数转化成DECIMAL值。
deccvdbl(double from, dec_t *to) 把C的双精度值转化成DECIMAL值。


2、DECIMAL函数——把DECIMAL值转换成字符型
dectoasc(dec_t *from, char *to, int len, int rt) 把DECIMAL值转换成ASCII字符串。
说明：
len串缓冲区字节的最大长度。
rt表示十进制小数右边十进制的位数。
注意事项：
（1）rt=-1，则十进制位的个数有*from的十进制值决定。
（2）如果此数不适合长度len的字符串，则该函数将这个数转换为指数表示的形式。如果仍不适合，则串用“*”号填满。如果数的长度短于串长，则右对齐且左部用空格填充。

dececvt(dec_t *from, int ndgt, int *decpt, int *sign) 将一十进制数转换成以空格结束的具有指定个数的字符串，且返回此字符串的指针。

decfcvt(dec_t *from, int ndgt, int *decpt, int *sign) 将一十进制数转换成以空格结束、小数点右边具有指定位数的字符串，且返回此字符串的指针。

rfmtdec(dec_t *from, char *format, char *to) 将DECIMAL值转换成格式化的字符串。

3、DECIMAL函数——把DECIMAL值转换成数值型
dectoint(dec_t *from, int *to);
dectolong(dec_t *from, long *to);
dectodbl(dec_t *from, double *to)

4、DECIMAL函数——算术运算
decadd(dec_t *op1, dec_t *op2, dec_t *result);
decsub(dec_t *op1, dec_t *op2, dec_t *result);
decmul(dec_t *op1, dec_t *op2, dec_t *result);
decdiv(dec_t *op1, dec_t *op2, dec_t *result);
返回代码：
0操作成功
-1200操作产生上溢
-1201操作产生下溢
-1202试图用零作除数

5、DECIMAL函数——DECIMAL操作
deccmp(dec_t *dec1, dec_t *dec2);
返回值：
-1dec10dec1=dec2
1dec1>dec2
DECUNKNOW有一个是空值

deccopy(dec_t *dec1, dec_t *dec2);
decround(dec_t *dec1, int scale);
dectrunc(dec_t *dec1, int scale);

二 、DATETIME和INTERVAL使用方式及实例
1、概述
DATETIME数据类型存放时间，时间由以下部分组成：YEAR，MONTH，DAY，HOUR，MINUTE，SECOND和秒的FRACTION(n)。
INTERVAL数据类型存放时间间隔，组成部分同上。

定义宿主变量：
DATETIME LargestQulifier TO SmallQulifier
INTERVAL LargestQulifier TO SmallQulifier
限定词：
YEAR，MO

NTH，DAY，HOUR，MINUTE，SECOND，FRACTION(n)
也可以不指明修饰符，直接定义。

2、DATETIME和INTERVAL宏及转换函数
在头文件datetime.h中定义了8个名字和5个宏，可以在操作DATETIME和INTERVAL值时使用它们。
名字
TU_YEAR用于YEAR修饰符域的名字
TU_MONTH
TU_HOUR
TU_DAY
TU_MINUTE
TU_SECOND
TU_FRAC用于开始的fraction修饰符域的名字
TU_Fn用于结束的fraction(n)修饰符域的名字(n=1～5)
宏
TU_LEN(q)
TU_START(q)
TU_END(q)
TU_DTENCODE(s,e)
TU_IENCODE(p,s,e)

3、DATETIME和字符串之间的转换函数
dtcvasc(char *from, dtime_t *to)把ANSI兼容的字符串转换为DATETIME值
dtcvfmtasc(char *from, char *fmt, dtime_t *to) 把格式化的字符串转换为DATETIME值。
dttoasc(dtime_t *from, char *to)
dttofmtasc(char *from, dtime_t *to, int len, char *fmt)
4、操作DATETIME值的函数
dtcurrent(dtime *to) 把当前日期和时间赋给一个DATETIME变量。
dtextent(dtime_t *from, dtime *to) 拷贝DATETIME值，使用的是不同的修饰符。

5、INTERVAL转换函数
incvasc(char *from, intrvl_t *to)把ANSI兼容的字符串转换为INTERVAL值
incvfmtasc(char *from, char *fmt, intrvl_t *to) 把格式化的字符串转换为INTERVAL值。
intoasc(char *from, intrvl_t *to)
intofmtasc(char *from, intrvl_t *to, int len, char *fmt)

6、提供DATETIME和INTERVAL算术操作的函数
rdtaddinv(dec_t *dt, int dg, dec_t *in, int iq, dec_t *sum) 把一个INTERVAL值加到一个DATETIME值上。
rdtsub(det_t *dt2, int dq2, dec_t *dt1, int dq1, dec_t *dt0, int dq0) 求两个DATETIME值的差。

7、DATE类型和DATETIME类型之间的转换
DATE→DATETIME
?;定义一个带有修饰符“year to day”的DATETIME变量
?;使用rfmtdate()函数把DATE值转换为一个字符串，使用的模板是yyyy-mm-dd
?;使用dtcvasc()函数把字符串转换成DATETIME类型变量的值。
?;如果需要的话，可以使用dtextend()函数来调整DATETIME的修饰符。

DATETIME→DATE
?;使用dtextend()函数把DATETIME的修饰符调整为“year to day”。
?;使用dttoasc()函数以模板yyyy-mm-dd创建一个字符串。
?;使用rdefmtdate()函数以模板yyyy-mm-dd把字符串转换为一个DATE值。

8、有关DATETIME和INTERVAL值的其他运算
rinvtodec(dec_t *v, int q, dec_t *dec) 把INTERVAL或DATETIME类型的值转换成DECIMAL类型
redectoinv(dec_t *dec, dec_t *v, int q) 把DECIMAL值转换成INTERVAL或DATETIME类型值