此语句关闭当前连接。事实上，这是 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 值。

比较两个十进制类型的变量。

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

该函数接收一个指向第一个十进制值的指针（arg1），一个指向第二个十进制值的指针（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。

将双精度类型的值转换为十进制类型的值。

int deccvdbl(double dbl, decimal *np);

该函数接收要转换的双精度类型变量作为其第一个参数（dbl）。作为第二个参数（np），该函数接收一个指向十进制变量的指针，该变量应保存操作的结果。

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

将 int 类型的值转换为十进制类型的值。

int deccvint(int in, decimal *np);

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

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

将 long 类型的值转换为十进制类型的值。

int deccvlong(long lng, decimal *np);

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

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

将两个十进制类型的变量相除。

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。

将十进制类型的变量转换为 C char* 字符串中的 ASCII 表示形式。

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

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

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

将十进制类型的变量转换为双精度类型。

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

该函数接收一个指向要转换的十进制值的指针（np），以及一个指向应保存操作结果的双精度变量的指针（dblp）。

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

将十进制类型的变量转换为整数。

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

该函数接收一个指向要转换的十进制值的指针（np），以及一个指向应保存操作结果的整数变量的指针（ip）。

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

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

将十进制类型的变量转换为长整数。

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

该函数接收一个指向要转换的十进制值的指针（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）以及指向日期类型变量的指针（d）。此函数不允许您指定格式掩码。它使用 Informix 的默认格式掩码，即 mm/dd/yyyy。在内部，此函数是通过 rdefmtdate 实现的。因此，rstrdate 并不更快，如果您有选择，则应选择 rdefmtdate，它允许您显式指定格式掩码。

该函数返回与 rdefmtdate 相同的值。

获取当前日期。

void rtoday(date *d);

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

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

从日期类型的变量中提取日、月和年的值。

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

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

目前，该函数始终返回 0。

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

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

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

该函数接收一个指向日期值的指针，该指针用于保存操作结果（d），用于解析日期的格式掩码（fmt）以及包含日期文本表示形式的 C char* 字符串（str）。文本表示形式应与格式掩码匹配。但是，您不需要字符串与格式掩码之间存在 1:1 的映射。该函数仅分析顺序，并查找指示年份位置的字面量 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）和一个指向日期类型变量的指针，该变量应保存操作结果。

目前，该函数始终返回 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；如果出错，则返回负值。

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

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

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

成功后，该函数返回 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 函数。有关可以使用哪些格式掩码说明符的信息，请参阅该处的参考资料。

将 interval 变量转换为 C char* 字符串。

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

该函数接收一个指向要转换的 interval 变量的指针（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）。它返回有效字符数，即不包含尾随空格的字符串长度。

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

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

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

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 定义)。

如果解析例程无法解析数字值的文本表示，因为它包含错误，或者如果例程无法完成涉及数字变量的计算，因为至少有一个数字变量无效，函数会返回此值。其内部定义为 -1213 ( Informix 定义)。

如果解析例程无法解析指数，函数会返回此值。其内部定义为 -1216 ( Informix 定义)。

如果解析例程无法解析日期，函数会返回此值。其内部定义为 -1218 ( Informix 定义)。

如果解析例程被传递了它无法解析的额外字符，函数会返回此值。其内部定义为 -1264 ( Informix 定义)。