此敘述會關閉目前的連線。實際上，這是 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。

將兩個 decimal 類型的值相加。

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 值的指標，該值儲存運算的結果。

有效的格式範例為：-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。

從一個十進位值減去另一個。

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 類型的變數轉換為 integer。

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

此函數接收指向要轉換的 decimal 值的指標 (np) 和指向應保存運算結果的 integer 變數的指標 (ip)。

成功時，返回 0；如果轉換失敗，則返回負值。如果發生溢位，則返回 ECPG_INFORMIX_NUM_OVERFLOW。

請注意，ECPG 實作與 Informix 實作不同。Informix 將整數限制為 -32767 到 32767 的範圍，而 ECPG 實作中的限制取決於架構 (INT_MIN .. INT_MAX)。

將 decimal 類型的變數轉換為 long integer。

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

此函數接收指向要轉換的 decimal 值的指標 (np) 和指向應保存運算結果的 long 變數的指標 (lngp)。

成功時，返回 0；如果轉換失敗，則返回負值。如果發生溢位，則返回 ECPG_INFORMIX_NUM_OVERFLOW。

請注意，ECPG 實作與 Informix 實作不同。Informix 將 long integer 限制為 -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 integer 值的陣列 mdy 的指標。變數名稱指示順序：mdy[0] 將設定為包含月份的數字，mdy[1] 將設定為日的值，mdy[2] 將包含年份。

目前，該函數始終返回 0。

在內部，此函數使用 PGTYPESdate_julmdy 函數。

使用格式遮罩將字元字串轉換為 date 類型的值。

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 個 short 整數陣列建立日期值。

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

此函式接收 3 個 short 整數的陣列（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；如果發生錯誤，則返回負值。

從另一個時間戳記中減去一個時間戳記，並傳回間隔類型變數。

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)。它會傳回有效字元的數量，即不含尾隨空白的字串長度。

將固定長度的字串複製到以 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 定義)。