这个语句关闭当前连接。实际上，这是ECPG的DISCONNECT CURRENT的同义词：

$CLOSE DATABASE;                /* close the current connection */
EXEC SQL CLOSE DATABASE;

由于ECPG的工作方式与Informix的ESQL/C有所不同（即，哪些步骤纯粹是语法转换，哪些步骤依赖于底层运行时库）， 在ECPG中没有FREE cursor_name语句。这是因为在ECPG中， DECLARE CURSOR不会转换为使用游标名称的运行时库的函数调用。 这意味着在ECPG运行时库中没有SQL游标的运行时记录，只在PostgreSQL服务器中有。

FREE statement_name是DEALLOCATE PREPARE statement_name的同义词。

SQLDA描述符中域的数量。

每一个域属性的指针。

未使用，用零字节填充。

已分配结构的尺寸。

如果结果集包含多于一个记录，这个域是下一个 SQLDA 结构的指针。

未使用的指针，包含 NULL。为 Informix-兼容性而保留。

域的类型。可以使用的常量定义在sqltypes.h中。

域数据的长度。

域数据的指针。该指针是char *类型，它所指向的数据是二进制个事。例子：

int intval;

switch (sqldata->sqlvar[i].sqltype)
{
    case SQLINTEGER:
        intval = *(int *)sqldata->sqlvar[i].sqldata;
        break;
  ...
}

NULL 指示符的指针。如果是由 DESCRIBE 或 FETCH 返回，那么它总是一个有效的指针。如果被用作EXECUTE ... USING sqlda;的输入，那么 NULL-指针值意味着这个域的值是非-NULL 的。否则必须正确地设置一个有效的指针和sqlitype。例子：

if (*(int2 *)sqldata->sqlvar[i].sqlind != 0)
    printf("value is NULL\n");

域的名称。以 0 终止的字符串。

在 Informix 中保留，是该域的PQfformat的值。

NULL 指示符数据的类型。当从服务器返回数据时，它总是 SQLSMINT。当SQLDA被用于一个参数化查询时，数据要根据设置的类型对待。

NULL 指示符数据的长度。

该域的扩展类型，PQftype的结果。

未使用。

如果sqllen大于 32kB，它等于sqldata。

添加两个十进制类型的值。

int decadd(decimal *arg1, decimal *arg2, decimal *sum);

该函数接收一个指向十进制类型第一个操作数的指针 (arg1)，一个指向十进制类型第二个操作数的指针 (arg2)，以及一个指向将包含和的十进制类型值的指针 (sum)。成功时，函数返回0。 溢出时返回ECPG_INFORMIX_NUM_OVERFLOW， 下溢时返回ECPG_INFORMIX_NUM_UNDERFLOW。 其他故障返回-1，并将errno设置为相应的pgtypeslib的errno编号。

比较两个decimal类型的变量。

int deccmp(decimal *arg1, decimal *arg2);

该函数接收第一个decimal值的指针 (arg1)，第二个decimal值的指针 (arg2)，并返回一个整数值，指示哪个值更大。

复制一个十进制值。

void deccopy(decimal *src, decimal *target);

该函数接收应该被复制的十进制值的指针作为第一个参数（src）， 并将目标类型为十进制的结构体的指针作为第二个参数（target）。

将一个值从其ASCII表示转换为十进制类型。

int deccvasc(char *cp, int len, decimal *np);

该函数接收一个指向包含要转换的数字的字符串表示的指针（cp）， 以及它的长度len。 np是一个指向保存操作结果的十进制值的指针。

例如，有效的格式包括： -2, .794, +3.44, 592.49E07或 -32.84e-4。

该函数成功返回0。如果发生溢出或下溢，则返回ECPG_INFORMIX_NUM_OVERFLOW或 ECPG_INFORMIX_NUM_UNDERFLOW。如果ASCII表示无法解析， 则返回ECPG_INFORMIX_BAD_NUMERIC，或者如果在解析指数时出现问题，则返回 ECPG_INFORMIX_BAD_EXPONENT。

将double类型的值转换为decimal类型的值。

int deccvdbl(double dbl, decimal *np);

该函数接收应该被转换的double类型变量作为其第一个参数（dbl）。 作为第二个参数（np），该函数接收一个指向应该保存操作结果的decimal变量的指针。

该函数在成功时返回0，在转换失败时返回负值。

将int类型的值转换为decimal类型的值。

int deccvint(int in, decimal *np);

该函数接收应该被转换的int类型变量作为其第一个参数（in）。 作为第二个参数（np），该函数接收一个指向应该保存操作结果的decimal变量的指针。

该函数在成功时返回0，在转换失败时返回负值。

将类型为long的值转换为类型为decimal的值。

int deccvlong(long lng, decimal *np);

该函数接收应该被转换的类型为long的变量作为其第一个参数（lng）。 作为第二个参数（np），该函数接收一个指向应该保存操作结果的decimal变量的指针。

该函数在成功时返回0，在转换失败时返回负值。

将两个decimal类型的变量相除。

int decdiv(decimal *n1, decimal *n2, decimal *result);

该函数接收指向第一个（n1）和第二个（n2）操作数的变量的指针， 并计算n1/n2。 result是应该保存操作结果的变量的指针。

在成功时返回0，如果除法失败则返回负值。 如果发生溢出或下溢，则函数分别返回 ECPG_INFORMIX_NUM_OVERFLOW或 ECPG_INFORMIX_NUM_UNDERFLOW。如果尝试 除以零，则函数返回ECPG_INFORMIX_DIVIDE_ZERO。

两个十进制值相乘。

int decmul(decimal *n1, decimal *n2, decimal *result);

该函数接收指向第一个（n1）和第二个（n2）操作数的变量的指针， 并计算n1*n2。 result是一个指向应该保存操作结果的变量的指针。

在成功时返回0，如果乘法失败则返回负值。如果发生溢出或下溢，函数分别返回 ECPG_INFORMIX_NUM_OVERFLOW或 ECPG_INFORMIX_NUM_UNDERFLOW。

从另一个十进制值中减去一个十进制值。

int decsub(decimal *n1, decimal *n2, decimal *result);

该函数接收指向第一个（n1）和第二个（n2）操作数的变量的指针， 并计算n1-n2。 result是应该保存操作结果的变量的指针。

在成功时返回0，如果减法失败则返回负值。如果发生溢出或下溢，函数分别返回 ECPG_INFORMIX_NUM_OVERFLOW或 ECPG_INFORMIX_NUM_UNDERFLOW。

将decimal类型的变量转换为C char*字符串中的ASCII表示。

int dectoasc(decimal *np, char *cp, int len, int right)

该函数接收一个指向decimal类型变量的指针（np），将其转换为文本表示。 cp是应该保存操作结果的缓冲区。参数right指定输出中小数点右侧应包含的位数。 结果将四舍五入到这个小数位数。将right设置为-1表示应在输出中包含所有可用的小数位数。 如果输出缓冲区的长度，由len指示，不足以容纳包括尾随零字节在内的文本表示， 则结果中仅存储一个*字符，并返回-1。

该函数返回-1，如果缓冲区cp太小，或者返回ECPG_INFORMIX_OUT_OF_MEMORY， 如果内存耗尽。

将类型为decimal的变量转换为double类型。

int dectodbl(decimal *np, double *dblp);

该函数接收一个指向要转换的decimal值的指针 (np)，以及一个指向应该保存操作结果的double变量的指针 (dblp)。

当成功时，返回0；如果转换失败，则返回负值。

将类型为decimal的变量转换为整数。

int dectoint(decimal *np, int *ip);

该函数接收一个指向要转换的decimal值的指针 (np)，以及一个指向应该保存操作结果的整数变量的指针 (ip)。

当成功时，返回0；如果转换失败，则返回负值。如果发生溢出，将返回ECPG_INFORMIX_NUM_OVERFLOW。

请注意，ECPG实现与Informix实现不同。 Informix将整数限制在-32767到32767的范围内， 而ECPG实现中的限制取决于架构（INT_MIN .. INT_MAX）。

将decimal类型的变量转换为长整型。

int dectolong(decimal *np, long *lngp);

该函数接收一个指向要转换的decimal值的指针 (np)，以及一个指向应该保存操作结果的长整型变量的指针 (lngp)。

当成功时，返回0；如果转换失败，则返回负值。如果发生溢出，将返回ECPG_INFORMIX_NUM_OVERFLOW。

请注意，ECPG实现与Informix实现不同。 Informix将长整型限制在-2,147,483,647到2,147,483,647的范围内， 而ECPG实现中的限制取决于架构（-LONG_MAX .. LONG_MAX）。

将日期转换为C char*字符串。

int rdatestr(date d, char *str);

该函数接收两个参数，第一个是要转换的日期（d），第二个是指向目标字符串的指针。 输出格式始终为yyyy-mm-dd，因此您需要为字符串分配至少11个字节（包括零字节终止符）。

该函数在成功时返回0，在错误时返回负值。

请注意，ECPG的实现与Informix的实现不同。在Informix中， 格式可以通过设置环境变量来影响。然而，在ECPG中，您无法更改输出格式。

解析日期的文本表示。

int rstrdate(char *str, date *d);

该函数接收要转换的日期的文本表示（str）和指向类型为date的变量的指针 （d）。此函数不允许您指定格式掩码。它使用Informix的默认格式掩码， 即mm/dd/yyyy。在内部，此函数通过rdefmtdate实现。 因此，rstrdate不会更快，如果可以选择，应选择允许您显式指定格式掩码的 rdefmtdate。

这个函数返回与rdefmtdate相同的值。

获取当前日期。

void rtoday(date *d);

该函数接收一个指向日期变量（d）的指针，将其设置为当前日期。

在内部，此函数使用PGTYPESdate_today函数。

从一个类型为date的变量中提取日、月和年的值。

int rjulmdy(date d, short mdy[3]);

该函数接收日期d和一个指向包含3个short整数值的数组mdy的指针。 变量名指示了顺序：mdy[0]将被设置为包含月份的数字， mdy[1]将被设置为日期的值，mdy[2]将包含年份。

这个函数目前总是返回0。

在内部，该函数使用PGTYPESdate_julmdy函数。

使用格式掩码将字符字符串转换为日期类型的值。

int rdefmtdate(date *d, char *fmt, char *str);

该函数接收一个指向应该保存操作结果的日期值的指针（d）， 用于解析日期的格式掩码（fmt）和包含日期文本表示的C char*字符串 （str）。文本表示应与格式掩码匹配。但是，您不需要将字符串 与格式掩码进行一一映射。该函数仅分析顺序顺序，并查找表示年份位置的文字 yy或yyyy，表示月份位置的mm 和表示日期位置的dd。

该函数返回以下值:

在内部，此函数实现为使用PGTYPESdate_defmt_asc函数。请参阅那里的参考资料，了解示例输入表。

将日期类型的变量使用格式掩码转换为其文本表示形式。

int rfmtdate(date d, char *fmt, char *str);

该函数接收要转换的日期（d）、格式掩码（fmt）和将保存日期文本表示的字符串（str）。

当成功时，返回0；发生错误时返回负值。

在内部，此函数使用PGTYPESdate_fmt_asc函数，有关示例，请参阅那里的参考资料。

从指定日期的一组3个短整数创建一个日期值，这些整数指定了日期的日、月和年。

int rmdyjul(short mdy[3], date *d);

该函数接收一个包含3个短整数的数组（mdy）和一个指向应该保存操作结果的date类型变量的指针。

目前该函数始终返回0。

在内部，该函数实现为使用函数PGTYPESdate_mdyjul。

返回表示日期值的星期几的数字。

int rdayofweek(date d);

该函数接收日期变量d作为其唯一参数，并返回一个整数，表示该日期的星期几。

在内部，该函数被实现为使用函数PGTYPESdate_dayofweek。

检索当前时间戳。

void dtcurrent(timestamp *ts);

该函数检索当前时间戳，并将其保存到ts指向的时间戳变量中。

将时间戳从其文本表示解析为时间戳变量。

int dtcvasc(char *str, timestamp *ts);

该函数接收要解析的字符串（str）和指向应该保存操作结果的时间戳变量的指针（ts）。

该函数在成功时返回0，在错误时返回负值。

在内部，此函数使用PGTYPEStimestamp_from_asc函数。请参阅那里的参考资料，了解包含示例输入的表格。

从文本表示中使用格式掩码解析时间戳为时间戳变量。

dtcvfmtasc(char *inbuf, char *fmtstr, timestamp *dtvalue)

该函数接收要解析的字符串（inbuf）、要使用的格式掩码 （fmtstr）以及应该保存操作结果的时间戳变量的指针 （dtvalue）。

这个函数是通过PGTYPEStimestamp_defmt_asc函数实现的。请参阅那里的文档，了解可用的格式说明符列表。

该函数在成功时返回0，在错误时返回负值。

从一个时间戳减去另一个时间戳，并返回一个间隔类型的变量。

int dtsub(timestamp *ts1, timestamp *ts2, interval *iv);

该函数将从ts1指向的时间戳变量中减去ts2指向的时间戳变量， 并将结果存储在iv指向的间隔变量中。

当成功时，该函数返回0，如果发生错误则返回负值。

将时间戳变量转换为C char*字符串。

int dttoasc(timestamp *ts, char *output);

该函数接收一个指向要转换的时间戳变量的指针 (ts)和应该保存操作结果的字符串 (output)。它根据SQL标准将ts转换为其 文本表示，格式为YYYY-MM-DD HH:MM:SS。

当成功时，该函数返回0，如果发生错误则返回负值。

将时间戳变量转换为C char*，使用格式掩码。

int dttofmtasc(timestamp *ts, char *output, int str_len, char *fmtstr);

该函数接收一个指向要转换的时间戳的指针作为第一个参数（ts）， 一个指向输出缓冲区的指针（output）， 为输出缓冲区分配的最大长度（str_len）， 以及用于转换的格式掩码（fmtstr）。

当成功时，该函数返回0，如果发生错误则返回负值。

在内部，此函数使用PGTYPEStimestamp_fmt_asc函数。请参阅那里的参考资料，了解可以使用哪些格式掩码说明符。

将一个区间变量转换为C char*字符串。

int intoasc(interval *i, char *str);

该函数接收一个指向要转换的区间变量的指针 (i)和应该保存操作结果的字符串 (str)。它根据SQL标准将i转换为其文本表示， 即YYYY-MM-DD HH:MM:SS。

当成功时，该函数返回0，如果发生错误则返回负值。

将长整型值使用格式掩码转换为其文本表示形式。

int rfmtlong(long lng_val, char *fmt, char *outbuf);

该函数接收长整型值lng_val，格式掩码fmt和指向输出缓冲区outbuf的指针。 它根据格式掩码将长整型值转换为其文本表示形式。

格式掩码可以由以下格式指定字符组成：

将字符串转换为大写。

void rupshift(char *str);

该函数接收一个指向字符串的指针，并将每个小写字符转换为大写。

返回字符串中字符的数量，不包括末尾的空格。

int byleng(char *str, int len);

该函数期望一个固定长度的字符串作为第一个参数 (str)，并将其长度作为第二个参数 (len)。它返回有效字符的数量，即不包括末尾空格的字符串长度。

将固定长度的字符串复制到以空字符结尾的字符串中。

void ldchar(char *src, int len, char *dest);

该函数接收要复制的固定长度字符串（src）、其长度（len）和指向目标内存的指针（dest）。 请注意，您需要为dest指向的字符串保留至少len+1字节。 该函数最多复制len字节到新位置（如果源字符串具有尾随空格，则会少一些），并添加空字符终止符。

int rgetmsg(int msgnum, char *s, int maxsize);

这个函数存在，但目前尚未实现！

int rtypalign(int offset, int type);

这个函数存在，但目前尚未实现！

int rtypmsize(int type, int len);

这个函数存在，但目前尚未实现！

int rtypwidth(int sqltype, int sqllen);

这个函数存在，但目前尚未实现！

将一个变量设置为NULL。

int rsetnull(int t, char *ptr);

该函数接收一个整数，表示变量的类型，以及一个指向变量本身的指针，该指针被转换为C中的char*指针。

下列类型存在：

这是调用此函数的示例：

$char c[] = "abc       ";
$short s = 17;
$int i = -74874;

rsetnull(CCHARTYPE, (char *) c);
rsetnull(CSHORTTYPE, (char *) &s);
rsetnull(CINTTYPE, (char *) &i);

测试变量是否为NULL。

int risnull(int t, char *ptr);

该函数接收要测试的变量类型（t）以及指向该变量的指针（ptr）。 请注意，后者需要转换为char*类型。查看函数rsetnull以获取可能的变量类型列表。

这是如何使用这个函数的示例：

$char c[] = "abc       ";
$short s = 17;
$int i = -74874;

risnull(CCHARTYPE, (char *) c);
risnull(CSHORTTYPE, (char *) &s);
risnull(CINTTYPE, (char *) &i);

如果在一次计算中发生了溢出，函数会返回这个值。在内部它被定义为 -1200（Informix定义）。

如果在一次计算中发生了下溢，函数会返回这个值。在内部它被定义为 -1201（Informix定义）。

如果发现尝试除零，函数会返回这个值。在内部它被定义为 -1202（Informix定义）。

如果在解析一个日期时为年找到了一个坏的值，函数会返回这个值。在内部它被定义为 -1204（Informix定义）。

如果在解析一个日期时为月找到了一个坏的值，函数会返回这个值。在内部它被定义为 -1205（Informix定义）。

如果在解析一个日期时为日找到了一个坏的值，函数会返回这个值。在内部它被定义为 -1206（Informix定义）。

如果一个解析例程需要一个短日期表示但是却没有得到正确长度的日期自如穿，函数会返回这个值。在内部它被定义为 -1209（Informix定义）。

如果在日期格式化时产生了一个错误，函数会返回这个值。在内部它被定义为 -1210（Informix定义）。

如果在操作时内存被耗尽，函数会返回这个值。在内部它被定义为 -1211（Informix定义）。

如果一个解析例程被假定为得到一个格式掩码（如mmddyy）但是列出的域并不是全部正确，函数会返回这个值。在内部它被定义为 -1212（Informix定义）。

如果一个解析例程因为一个numeric值的文本表达包含错误而不能解析它或者一个例程因为至少一个numeric变量非法而无法完成一次涉及numeric变量的计算，函数会返回这个值。在内部它被定义为 -1213（Informix定义）。

如果一个解析例程不能解析一个指数，函数会返回这个值。在内部它被定义为 -1216（Informix定义）。

如果一个解析例程不能解析一个日期，函数会返回这个值。在内部它被定义为 -1218（Informix定义）。

如果一个解析例程被传递了它不能解析的额外字符，函数会返回这个值。在内部它被定义为 -1264（Informix定义）。