ecpg-informix-compat.md

## 36.15.Informix兼容模式

[36.15.1. 其他类型](ecpg-informix-compat.html#ECPG-INFORMIX-TYPES)

[36.15.2. 附加/缺少嵌入式SQL语句](ecpg-informix-compat.html#ECPG-INFORMIX-STATEMENTS)

[36.15.3. Informix兼容的SQLDA描述符区域](ecpg-informix-compat.html#ECPG-INFORMIX-SQLDA)

[36.15.4. 附加功能](ecpg-informix-compat.html#ECPG-INFORMIX-FUNCTIONS)

[36.15.5. 附加常数](ecpg-informix-compat.html#ECPG-INFORMIX-CONSTANTS)

`ecpg`可以在所谓的*Informix兼容模式*。如果此模式处于活动状态，它会尝试将其作为Informix E/SQL的Informix预编译器。一般来说，这将允许你使用美元符号，而不是美元符号`执行SQL`用于引入嵌入式SQL命令的基元：

```
$int j = 3;
$CONNECT TO :dbname;
$CREATE TABLE test(i INT PRIMARY KEY, j INT);
$INSERT INTO test(i, j) VALUES (7, :j);
$COMMIT;
```

### 笔记

两个选项之间不得有任何空白`$`下面是一个预处理器指令，`包括`,`定义`,`条件编译`否则，预处理器将把令牌解析为主机变量。

有两种兼容模式：`INFORMIX`,`INFORMIX_SE`

链接使用此兼容模式的程序时，请记住链接到`利比卡特`这是ECPG附带的。

除了前面解释的语法糖之外，Informix兼容模式还移植了一些用于数据输入、输出和转换的函数，以及从E/SQL到ECPG的嵌入式SQL语句。

Informix兼容模式与ECPG的pgtypeslib库紧密相连。pgtypeslib将SQL数据类型映射到C主机程序内的数据类型，Informix兼容模式的大多数附加功能允许您在这些C主机程序类型上操作。但是请注意，兼容性的范围是有限的。它不试图复制Informix行为；它允许您执行或多或少相同的操作，并为您提供具有相同名称和相同基本行为的函数，但如果您目前正在使用Informix，它不是替代品。此外，有些数据类型是不同的。例如，PostgreSQL的datetime和interval类型不知道范围，例如`年复一年`所以你也不会在ECPG中找到支持。

### 36.15.1.其他类型

在Informix模式下，现在支持存储右修剪字符串数据的Informix特殊“string”伪类型，而无需使用`类型定义`事实上，在Informix模式下，ECPG拒绝处理包含`typedef sometype字符串；`

```
EXEC SQL BEGIN DECLARE SECTION;
string userid; /* this variable will contain trimmed data */
EXEC SQL END DECLARE SECTION;

EXEC SQL FETCH MYCUR INTO :userid;
```

### 36.15.2.附加/缺少嵌入式SQL语句

`关闭数据库`

此语句关闭当前连接。事实上，这是ECPG的同义词`断开电流`:

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

`自由游标名称`

由于ECPG的工作方式与Informix的ESQL/C（即，哪些步骤纯粹是语法转换，哪些步骤依赖于底层的运行时库）不同，因此没有任何区别`自由游标名称`ECPG中的声明。这是因为在ECPG中，`声明游标`不会转换为对运行时库的函数调用，该库使用游标名称。这意味着ECPG运行时库中没有SQL游标的运行时簿记，只有在PostgreSQL server中。

`自由声明`

`自由声明`是的同义词`取消分配准备语句\u名称`.

### 36.15.3.Informix兼容的SQLDA描述符区域

Informix兼容模式支持与中描述的不同的结构[第36.7.2节](ecpg-descriptors.html#ECPG-SQLDA-DESCRIPTORS).见下文：

```
struct sqlvar_compat
{
    short   sqltype;
    int     sqllen;
    char   *sqldata;
    short  *sqlind;
    char   *sqlname;
    char   *sqlformat;
    short   sqlitype;
    short   sqlilen;
    char   *sqlidata;
    int     sqlxid;
    char   *sqltypename;
    short   sqltypelen;
    short   sqlownerlen;
    short   sqlsourcetype;
    char   *sqlownername;
    int     sqlsourceid;
    char   *sqlilongdata;
    int     sqlflags;
    void   *sqlreserved;
};

struct sqlda_compat
{
    short  sqld;
    struct sqlvar_compat *sqlvar;
    char   desc_name[19];
    short  desc_occ;
    struct sqlda_compat *desc_next;
    void  *reserved;
};

typedef struct sqlvar_compat    sqlvar_t;
typedef struct sqlda_compat     sqlda_t;
```

全局属性包括：

`sqld`

表中的字段数`SQLDA`描述符。

`sqlvar`

指向每个字段属性的指针。

`描述你的名字`

未使用，填充了零字节。

`描述`

分配结构的大小。

`下一步`

如果结果集包含多条记录，则指向下一个SQLDA结构的指针。

`含蓄的`

未使用的指针，包含NULL。保持Informix兼容性。

每个字段的属性如下所示，它们存储在`sqlvar`数组：

`sqltype`

字段的类型。常数在`sqltypes。H`

`sqllen`

字段数据的长度。

`sqldata`

指向字段数据的指针。指针是`炭*`类型，它所指向的数据是二进制格式的。例子：

```
int intval;

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

`sqlind`

指向空指示器的指针。如果由descripe或FETCH返回，则它始终是有效指针。如果用作`处决使用sqlda；`空指针值意味着这个字段的值不是空的。否则为有效指针和`sqlitype`必须正确设置。例子：

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

`sqlname`

字段的名称。以0结尾的字符串。

`sqlformat`

保留在Informix中，值[`PQfformat`](libpq-exec.html#LIBPQ-PQFFORMAT)在球场上。

`sqlitype`

空指示符数据的类型。从服务器返回数据时总是使用SQLSMINT。当`SQLDA`用于参数化查询，根据集合类型处理数据。

`sqlilen`

空指示符数据的长度。

`sqlxid`

字段的扩展类型，结果为[`PQftype`](libpq-exec.html#LIBPQ-PQFTYPE).

`sqltypename`\
`sqltypelen`\
`sqlownerlen`\
`sqlsourcetype`\
`sqlownername`\
`sqlsourceid`\
`sqlflags`\
`sqlreserved`

没用过。

`sqlilongdata`

等于`sqldata`如果`sqllen`大于32kB。

例子：

```
EXEC SQL INCLUDE sqlda.h;

    sqlda_t        *sqlda; /* This doesn't need to be under embedded DECLARE SECTION */

    EXEC SQL BEGIN DECLARE SECTION;
    char *prep_stmt = "select * from table1";
    int i;
    EXEC SQL END DECLARE SECTION;

    ...

    EXEC SQL PREPARE mystmt FROM :prep_stmt;

    EXEC SQL DESCRIBE mystmt INTO sqlda;

    printf("# of fields: %d\n", sqlda->sqld);
    for (i = 0; i < sqlda->sqld; i++)
      printf("field %d: \"%s\"\n", sqlda->sqlvar[i]->sqlname);

    EXEC SQL DECLARE mycursor CURSOR FOR mystmt;
    EXEC SQL OPEN mycursor;
    EXEC SQL WHENEVER NOT FOUND GOTO out;

    while (1)
    {
      EXEC SQL FETCH mycursor USING sqlda;
    }

    EXEC SQL CLOSE mycursor;

    free(sqlda); /* The main structure is all to be free(),
                  * sqlda and sqlda->sqlvar is in one allocated area */
```

有关更多信息，请参阅`sqlda。H`标题和标题`src/interfaces/ecpg/test/compat_informix/sqlda。pgc`回归测试。

### 36.15.4.附加功能

`脱卡`

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

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

该函数接收指向decimal类型的第一个操作数的指针(`arg1`)，指向十进制类型的第二个操作数的指针(`arg2`)以及一个指向将包含总和的十进制类型值的指针(`总和`).成功后，函数返回0.`ECPG_INFORMIX_NUM_溢出`在溢出和`ECPG_INFORMIX_NUM_下溢`以防下溢-对于其他故障和故障，返回1`呃不`设置为相应的`呃不`pgtypeslib的编号。

`deccmp`

比较decimal类型的两个变量。

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

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

-   1.如果该值`arg1`指向的值大于`var2`指向

-   \-1.如果该值`arg1`指向的值小于`arg2`指向

-   0，如果该值`arg1`指的是`arg2`分数相等

`decopy`

复制一个十进制值。

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

该函数接收一个指向应作为第一个参数复制的十进制值的指针(`src`)以及指向decimal类型的目标结构的指针(`目标`)作为第二个论点。

`deccvasc`

将ASCII表示形式的值转换为十进制类型。

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

函数接收一个指向字符串的指针，该字符串包含要转换的数字的字符串表示形式(`内容提供商`)以及它的长度`伦恩`. `np`是指向保存操作结果的十进制值的指针。

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

函数在成功时返回0.如果发生溢流或下溢，`ECPG_INFORMIX_NUM_溢出`或`ECPG_INFORMIX_NUM_下溢`被退回。如果无法解析ASCII表示形式，`ECPG_INFORMIX_BAD_NUMERIC`被退回或`ECPG_INFORMIX_BAD_指数`如果在分析指数时出现此问题。

`deccvdbl`

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

```
int deccvdbl(double dbl, decimal *np);
```

函数接收应该转换为其第一个参数的double类型的变量(`dbl`).作为第二个论点(`np`)，该函数接收一个指向十进制变量的指针，该变量应保存操作结果。

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

`deccvint`

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

```
int deccvint(int in, decimal *np);
```

函数接收int类型的变量，该变量应转换为其第一个参数(`在里面`).作为第二个论点(`np`)，该函数接收一个指向十进制变量的指针，该变量应保存操作结果。

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

`德克夫隆`

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

```
int deccvlong(long lng, decimal *np);
```

函数接收long类型的变量，该变量应作为其第一个参数进行转换(`液化天然气`).作为第二个论点(`np`)，该函数接收一个指向十进制变量的指针，该变量应保存操作结果。

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

`德克迪夫`

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

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

函数接收指向第一个变量的指针(`n1`)第二个呢(`n2`)操作数和计算`n1`/`n2`. `后果`是指向应保存操作结果的变量的指针。

成功时，返回0，如果除法失败，则返回负值。如果发生溢出或下溢，函数返回`ECPG_INFORMIX_NUM_溢出`或`ECPG_INFORMIX_NUM_下溢`分别地如果观察到被零除的尝试，函数将返回`ECPG_INFORMIX_DIVIDE_ZERO`.

`德克穆尔`

将两个十进制值相乘。

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

函数接收指向第一个变量的指针(`n1`)第二个呢(`n2`)操作数和计算`n1`\*`n2`. `后果`是指向应保存操作结果的变量的指针。

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

`德克苏布`

用一个十进制值减去另一个十进制值。

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

函数接收指向第一个变量的指针(`n1`)第二个呢(`n2`)操作数和计算`n1`-`n2`. `后果`是指向应保存操作结果的变量的指针。

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

`十二月`

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

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

函数接收指向decimal类型变量的指针(`np`)它转换为文本表示。`内容提供商`应该保存操作结果的缓冲区。参数`正当`指定输出中小数点右侧的位数。结果将四舍五入到这个小数位数。背景`正当`to-1表示输出中应包含所有可用的十进制数字。如果输出缓冲区的长度由`伦恩`不足以保存文本表示，包括尾随的零字节，只有一个`*`字符存储在结果中，并返回-1.

如果缓冲区`内容提供商`太小或太小`ECPG_INFORMIX_内存不足`如果记忆耗尽。

`十二月`

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

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

函数接收指向要转换的十进制值的指针(`np`)以及一个指向应该保存操作结果的双变量的指针(`dblp`).

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

`十进位`

将变量转换为十进制类型，并将其转换为整数。

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

函数接收指向要转换的十进制值的指针(`np`)以及一个指向整数变量的指针，该整数变量应包含运算结果(`知识产权`).

如果转换成功，则返回0，如果转换失败，则返回负值。如果发生溢出，`ECPG_INFORMIX_NUM_溢出`被退回。

请注意，ECPG实现与Informix实现不同。Informix将整数限制在-32767到32767之间，而ECPG实现中的限制取决于体系结构(`INT_MIN。。INT_MAX`).

`十点钟`

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

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

函数接收指向要转换的十进制值的指针(`np`)以及一个指向长变量的指针，该变量应该保存操作的结果(`lngp`).

如果转换成功，则返回0，如果转换失败，则返回负值。如果发生溢出，`ECPG_INFORMIX_NUM_溢出`被退回。

请注意，ECPG实现与Informix实现不同。Informix将长整数限制在-2147483647到2147483647之间，而ECPG实现中的限制取决于体系结构(`-朗·麦克斯。。朗普马克斯`).

`rdatestr`

将日期转换为C字符\*一串

```
int rdatestr(date d, char *str);
```

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

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

请注意，ECPG的实现与Informix实现不同。在Informix中，设置环境变量会影响格式。但是，在ECPG中，不能更改输出格式。

`rstrdate`

解析日期的文本表示。

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

函数接收要转换的日期的文本表示(`str`)以及指向日期类型变量的指针(`d`).此函数不允许您指定格式掩码。它使用Informix的默认格式掩码，即`年月日`.在内部，该功能通过`rdefmtdate`因此`rstrdate`不是更快，如果你有选择，你应该选择`rdefmtdate`它允许您明确指定格式掩码。

该函数返回的值与`rdefmtdate`.

`今天`

获取当前日期。

```
void rtoday(date *d);
```

函数接收指向日期变量的指针(`d`)将其设置为当前日期。

在内部，该函数使用[`今天是你的生日`](ecpg-pgtypes.html#PGTYPESDATETODAY)作用

`鲁姆迪`

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

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

函数接收日期`d`以及指向3个短整数值数组的指针`麦迪`.变量名表示顺序：`mdy[0]`将设置为包含月份的编号，`mdy[1]`将设置为当天的值`mdy[2]`将包含全年。

函数此时总是返回0.

函数在内部使用[`PGTYPESdate_julmdy`](ecpg-pgtypes.html#PGTYPESDATEJULMDY)作用

`rdefmtdate`

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

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

该函数接收一个指向应该保存操作结果的日期值的指针(`d`)，用于解析日期的格式掩码(`fmt`)还有C字符\*包含日期文本表示形式的字符串(`str`).文本表示形式应与格式掩码匹配。但是，不需要将字符串与格式掩码进行1:1映射。该函数只分析顺序并查找文字`yy`或`年份`这表明了今年的形势，`嗯`表示月份的位置，以及`dd`指示当天的位置。

该函数返回以下值：

-   0-函数已成功终止。

-   `ECPG_INFORMIX_ENOSHORTDATE`-日期不包含日期、月份和年份之间的分隔符。在这种情况下，输入字符串的长度必须正好为6或8字节，但不是。

-   `ECPG_INFORMIX_enotdmay`-格式字符串未正确指示年、月和日的顺序。

-   `ECPG_INFORMIX_BAD_DAY`-输入字符串不包含有效的日期。

-   `ECPG_INFORMIX_BAD_MONTH`-输入字符串不包含有效的月份。

-   `ECPG_INFORMIX_BAD_YEAR`-输入字符串不包含有效的年份。

    在内部，该功能的实现是为了使用[`PGTYPESdate_defmt_asc`](ecpg-pgtypes.html#PGTYPESDATEDEFMTASC)作用有关示例输入的表格，请参见此处的参考资料。

`rfmtdate`

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

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

函数接收要转换的日期(`d`)，格式掩码(`fmt`)以及保存日期文本表示形式的字符串(`str`).

成功时，将返回0，如果发生错误，则返回负值。

在内部，该函数使用[`PGTYPESdate_fmt_asc`](ecpg-pgtypes.html#PGTYPESDATEFMTASC)函数，请参见此处的参考以获取示例。

`rmdyjul`

从指定日期的日期、月份和年份的3个短整数数组中创建日期值。

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

函数接收3个短整数的数组(`麦迪`)以及一个指向date类型的变量的指针，该变量应保存操作的结果。

当前，该函数始终返回0.

在内部实现该函数以使用该函数[`PGTYPESdate_mdyjul`](ecpg-pgtypes.html#PGTYPESDATEMDYJUL).

`星期五`

为日期值返回一个代表一周中某一天的数字。

```
int rdayofweek(date d);
```

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

-   0-周日

-   1-星期一

-   2-星期二

-   3-星期三

-   4-周四

-   5-周五

-   6-周六

    在内部实现该函数以使用该函数[`PGTYPESdate_dayofweek`](ecpg-pgtypes.html#PGTYPESDATEDAYOFWEEK).

`数据流`

检索当前时间戳。

```
void dtcurrent(timestamp *ts);
```

函数检索当前时间戳并将其保存到`ts`指向。

`dtcvasc`

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

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

函数接收要分析的字符串(`str`)以及指向应该保存操作结果的时间戳变量的指针(`ts`).

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

在内部，该函数使用[`PGTYPEStimestamp_来自asc`](ecpg-pgtypes.html#PGTYPESTIMESTAMPFROMASC)作用有关输入示例的表格，请参见此处的参考资料。

`dtcvfmtasc`

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

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

函数接收要分析的字符串(`输入存储器`)，要使用的格式掩码(`fmtstr`)以及指向应该保存操作结果的时间戳变量的指针(`dtvalue`).

此功能通过[`PGTYPEStimestamp_defmt_asc`](ecpg-pgtypes.html#PGTYPESTIMESTAMPDEFMTASC)作用有关可使用的格式说明符的列表，请参阅文档。

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

`dtsub`

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

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

该函数将减去`ts2`从timestamp变量中指向`ts1`指向并将结果存储在`四、`指向。

成功后，如果发生错误，函数将返回0和负值。

`dttoasc`

将时间戳变量转换为C字符\*一串

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

函数接收指向要转换的时间戳变量的指针(`ts`)以及应该保存操作结果的字符串(`输出`).它改变了信仰`ts`根据SQL标准对其进行文本表示，即`YYYY-MM-DD HH:MM:SS`.

成功后，如果发生错误，函数将返回0和负值。

`dttofmtasc`

将时间戳变量转换为C字符\*使用格式掩码。

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

函数接收指向要转换的时间戳的指针作为其第一个参数(`ts`)，指向输出缓冲区的指针(`输出`)，为输出缓冲区分配的最大长度(`斯特鲁伦`)以及用于转换的格式掩码(`fmtstr`).

成功后，如果发生错误，函数将返回0和负值。

在内部，此函数使用[`PGTYPEStimestamp_fmt_asc`](ecpg-pgtypes.html#PGTYPESTIMESTAMPFMTASC)作用有关可以使用何种格式掩码说明符的信息，请参阅参考资料。

`英托阿斯克`

将区间变量转换为C字符\*一串

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

函数接收指向要转换的间隔变量的指针(`我`)以及应该保存操作结果的字符串(`str`).它改变了信仰`我`根据SQL标准对其进行文本表示，即`YYYY-MM-DD HH:MM:SS`.

成功后，如果发生错误，函数将返回0和负值。

`rfmtlong`

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

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

函数接收长值`液化天然气`，格式掩码`fmt`以及指向输出缓冲区的指针`爆发`。它根据格式掩码将长值转换为其文本表示形式。

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

-   `*`（星号）-如果该位置为空，则用星号填充。

-   `&`（符号）-如果此位置为空，则用零填充。

-   `#`-将前导零变成空格。

-   `<`-左对齐字符串中的数字。

-   `,`（逗号）-将四位或四位以上的数字分组为三位数字，并用逗号分隔。

-   `.`（句号）-此字符将数字的整数部分与小数部分分开。

-   `-`（减号）-如果数字为负值，则会出现减号。

-   `+`（加号）-如果数字为正值，则会显示加号。

-   `(`-这将替换负数前面的减号。减号不会出现。

-   `)`-此字符替换负号，并打印在负值后面。

-   `$`-货币符号。

`rupshift`

将字符串转换为大写。

```
void rupshift(char *str);
```

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

`拜伦`

返回字符串中的字符数，不计算尾随空格。

```
int byleng(char *str, int len);
```

函数需要一个固定长度的字符串作为其第一个参数(`str`)它的长度是它的第二个参数(`伦恩`)。它返回有效字符数，即不带尾随空格的字符串长度。

`ldchar`

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

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

函数接收要复制的固定长度字符串(`src`)，它的长度(`伦恩`)以及指向目标内存的指针(`目的地`).请注意，您至少需要预订`len+1`字节的字符串`目的地`指向。函数最多只能复制`伦恩`字节添加到新位置（如果源字符串有尾随空格，则减少），并添加空终止符。

`味精`

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

此功能存在，但目前尚未实现！

`rtypalign`

```
int rtypalign(int offset, int type);
```

此功能存在，但目前尚未实现！

`rtypmsize`

```
int rtypmsize(int type, int len);
```

此功能存在，但目前尚未实现！

`rtypwidth`

```
int rtypwidth(int sqltype, int sqllen);
```

此功能存在，但目前尚未实现！

`塞特努尔`

将变量设置为NULL。

```
int rsetnull(int t, char *ptr);
```

该函数接收一个指示变量类型的整数和一个指向变量本身的指针，该指针被转换为C字符\*指针。

存在以下类型：

-   `CCHARTYPE`-对于类型为`烧焦`或`炭*`

-   `CSHORTTYPE`-对于类型为`短整型`

-   `CINTTYPE`- 对于类型的变量`整数`

-   `CBOOLTYPE`- 对于类型的变量`布尔值`

-   `CFLOATTYPE`- 对于类型的变量`漂浮`

-   `克隆型`- 对于类型的变量`长`

-   `CDOUBLETYPE`- 对于类型的变量`双倍的`

-   `CDECIMALTYPE`- 对于类型的变量`十进制`

-   `CDATETYPE`- 对于类型的变量`日期`

-   `CDTIMETYPE`- 对于类型的变量`时间戳`

    下面是一个调用这个函数的例子：


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

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

`risnull`

测试变量是否为 NULL。

```
int risnull(int t, char *ptr);
```

该函数接收要测试的变量的类型 (`吨`) 以及指向该变量的指针 (`指针`).请注意，后者需要转换为char\*.查看函数[`塞特努尔`](ecpg-informix-compat.html#RSETNULL)查看可能的变量类型列表。

以下是如何使用此功能的示例：

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

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

### 36.15.5.附加常数

请注意，这里的所有常量都描述了错误，所有这些常量都被定义为表示负值。在不同常量的描述中，您还可以找到这些常量在当前实现中表示的值。然而，你不应该依赖这个数字。然而，你可以依赖这样一个事实：它们都被定义为代表负值。

`ECPG_INFORMIX_NUM_溢出`

如果计算中发生溢出，函数将返回此值。在内部，它被定义为-1200（Informix定义）。

`ECPG_INFORMIX_NUM_下溢`

如果计算中出现下溢，函数将返回此值。内部定义为-1201（Informix定义）。

`ECPG_INFORMIX_DIVIDE_ZERO`

如果观察到尝试除以零，函数将返回此值。内部定义为-1202（Informix定义）。

`ECPG_INFORMIX_BAD_YEAR`

如果在分析日期时发现某一年的值不正确，函数将返回此值。内部定义为-1204（Informix定义）。

`ECPG_INFORMIX_BAD_MONTH`

如果在分析日期时发现某个月的值不正确，函数将返回此值。内部定义为-1205（Informix定义）。

`ECPG_INFORMIX_BAD_DAY`

如果在分析日期时发现某一天的值不正确，函数将返回此值。内部定义为-1206（Informix定义）。

`ECPG_INFORMIX_ENOSHORTDATE`

如果解析例程需要较短的日期表示，但没有获得正确长度的日期字符串，函数将返回此值。内部定义为-1209（Informix定义）。

`ECPG_INFORMIX_DATE_CONVERT`

如果在日期格式化过程中发生错误，函数将返回此值。在内部，它被定义为-1210（Informix定义）。

`ECPG_INFORMIX_内存不足`

如果操作期间内存耗尽，函数将返回此值。内部定义为-1211（Informix定义）。

`ECPG_INFORMIX_enotdmay`

如果解析例程应该获得格式掩码（如`嗯`)但并非所有字段都正确列出。内部定义为-1212（Informix定义）。

`ECPG_INFORMIX_BAD_NUMERIC`

如果解析例程因包含错误而无法解析数值的文本表示形式，或者例程因至少一个数值变量无效而无法完成涉及数值变量的计算，则函数返回此值。内部定义为-1213（Informix定义）。

`ECPG_INFORMIX_BAD_指数`

如果解析例程无法解析指数，函数将返回此值。内部定义为-1216（Informix定义）。

`ECPG_INFORMIX_BAD_DATE`

如果解析例程无法解析日期，函数将返回此值。内部定义为-1218（Informix定义）。

`ECPG_INFORMIX_额外_CHARS`

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