此語句關閉當前連線。實際上，它是 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);

該函式接收第一個運算元（型別為 decimal）的指標（arg1），第二個運算元（型別為 decimal）的指標（arg2）以及將儲存和的 decimal 型別值的指標（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），並返回一個整數值，指示哪個值更大。

複製 decimal 值。

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

該函式接收應複製的 decimal 值的指標作為第一個引數（src），並接收目標結構（型別為 decimal）的指標作為第二個引數（target）。

將值從其 ASCII 表示形式轉換為 decimal 型別。

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

該函式接收包含要轉換的數字的字串表示的指標（cp）及其長度 len。np 是一個指向 decimal 值的指標，用於儲存操作結果。 0 - 成功時，函式返回 0。如果發生溢位或下溢，則返回 ECPG_INFORMIX_NUM_OVERFLOW 或 ECPG_INFORMIX_NUM_UNDERFLOW。如果無法解析 ASCII 表示形式，則返回 ECPG_INFORMIX_BAD_NUMERIC；如果在解析指數時發生此問題，則返回 ECPG_INFORMIX_BAD_EXPONENT。

有效格式例如： -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。

乘以兩個 decimal 值。

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

該函式接收指向作為第一個（n1）和第二個（n2）運算元的變數的指標，並計算 n1*n2。result 是一個指向應儲存操作結果的變數的指標。

成功時，返回 0，如果乘法失敗，則返回負值。如果發生溢位或下溢，函式分別返回 ECPG_INFORMIX_NUM_OVERFLOW 或 ECPG_INFORMIX_NUM_UNDERFLOW。

從一個 decimal 值中減去另一個 decimal 值。

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。

如果緩衝區 cp 太小，函式返回 -1；如果記憶體耗盡，則返回 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);

該函式接收一個指向 date 變數的指標（d），並將其設定為當前日期。

內部來說，此函式使用 PGTYPESdate_today 函式。

從 date 型別變數中提取日、月、年的值。

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

該函式接收日期 d 和一個指向包含 3 個 short int 值的陣列的指標 mdy。變數名錶示順序：mdy[0] 將被設定為包含月份編號，mdy[1] 將被設定為日期值，mdy[2] 將包含年份。

目前該函式始終返回 0。

內部來說，該函式使用 PGTYPESdate_julmdy 函式。

使用格式掩碼將字元字串轉換為 date 型別值。

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

該函式接收指向應儲存操作結果的 date 值的指標（d），用於解析日期的格式掩碼（fmt），以及包含日期文字表示的 C char* 字串（str）。文字表示應與格式掩碼匹配。但是，您不需要將字串與格式掩碼進行 1:1 對映。該函式僅分析順序並查詢表示年份位置的文字 yy 或 yyyy，表示月份位置的 mm，以及表示日期位置的 dd。

該函式返回以下值：

內部來說，此函式被實現為使用 PGTYPESdate_defmt_asc 函式。有關示例輸入的表格，請參閱該處的參考。

使用格式掩碼將 date 型別變數轉換為其文字表示。

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

該函式接收要轉換的日期（d），格式掩碼（fmt），以及將儲存日期文字表示的字串（str）。

成功時，返回 0，如果發生錯誤，則返回負值。

內部來說，此函式使用 PGTYPESdate_fmt_asc 函式，有關示例，請參閱該處的參考。

從包含日期日、月、年的 3 個 short int 陣列建立 date 值。

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

該函式接收 3 個 short int 陣列（mdy）以及指向應儲存結果的 date 型別變數的指標。

目前函式始終返回 0。

內部來說，函式被實現為使用 PGTYPESdate_mdyjul 函式。

返回一個數字，表示 date 值的星期幾。

int rdayofweek(date d);

該函式接收 date 變數 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);

該函式將 ts2 指向的時間戳變數從 ts1 指向的時間戳變數中減去，並將結果儲存在 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 個位元組複製到新位置（如果源字串有尾隨空格，則複製的位元組數會少於 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 定義）。