这是在 ECPG 主机应用程序中处理 timestamp 变量的模式。

首先，程序必须包含 timestamp 类型的头文件

#include <pgtypes_timestamp.h>

接下来，在声明部分中将主机变量声明为 timestamp 类型

EXEC SQL BEGIN DECLARE SECTION;
timestamp ts;
EXEC SQL END DECLARE SECTION;

并且在将值读取到主机变量后，使用 pgtypes 库函数对其进行处理。在以下示例中，使用 PGTYPEStimestamp_to_asc() 函数将 timestamp 值转换为文本 (ASCII) 形式

EXEC SQL SELECT now()::timestamp INTO :ts;

printf("ts = %s\n", PGTYPEStimestamp_to_asc(ts));

此示例将显示如下结果

ts = 2010-06-27 18:03:56.949343

此外，DATE 类型可以用相同的方式处理。程序必须包含 pgtypes_date.h，将主机变量声明为 date 类型，并使用 PGTYPESdate_to_asc() 函数将 DATE 值转换为文本形式。有关 pgtypes 库函数的更多详细信息，请参阅第 34.6 节。

处理 interval 类型也类似于 timestamp 和 date 类型。但是，需要显式地为 interval 类型值分配内存。换句话说，变量的内存空间必须在堆内存中分配，而不是在栈内存中分配。

这是一个示例程序

#include <stdio.h>
#include <stdlib.h>
#include <pgtypes_interval.h>

int
main(void)
{
EXEC SQL BEGIN DECLARE SECTION;
    interval *in;
EXEC SQL END DECLARE SECTION;

    EXEC SQL CONNECT TO testdb;
    EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT;

    in = PGTYPESinterval_new();
    EXEC SQL SELECT '1 min'::interval INTO :in;
    printf("interval = %s\n", PGTYPESinterval_to_asc(in));
    PGTYPESinterval_free(in);

    EXEC SQL COMMIT;
    EXEC SQL DISCONNECT ALL;
    return 0;
}

处理 numeric 和 decimal 类型类似于 interval 类型：它需要定义一个指针，在堆上分配一些内存空间，并使用 pgtypes 库函数访问变量。有关 pgtypes 库函数的更多详细信息，请参阅第 34.6 节。

没有专门为 decimal 类型提供的函数。应用程序必须使用 pgtypes 库函数将其转换为 numeric 变量以进行进一步处理。

这是一个处理 numeric 和 decimal 类型变量的示例程序。

#include <stdio.h>
#include <stdlib.h>
#include <pgtypes_numeric.h>

EXEC SQL WHENEVER SQLERROR STOP;

int
main(void)
{
EXEC SQL BEGIN DECLARE SECTION;
    numeric *num;
    numeric *num2;
    decimal *dec;
EXEC SQL END DECLARE SECTION;

    EXEC SQL CONNECT TO testdb;
    EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT;

    num = PGTYPESnumeric_new();
    dec = PGTYPESdecimal_new();

    EXEC SQL SELECT 12.345::numeric(4,2), 23.456::decimal(4,2) INTO :num, :dec;

    printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 0));
    printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 1));
    printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 2));

    /* Convert decimal to numeric to show a decimal value. */
    num2 = PGTYPESnumeric_new();
    PGTYPESnumeric_from_decimal(dec, num2);

    printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 0));
    printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 1));
    printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 2));

    PGTYPESnumeric_free(num2);
    PGTYPESdecimal_free(dec);
    PGTYPESnumeric_free(num);

    EXEC SQL COMMIT;
    EXEC SQL DISCONNECT ALL;
    return 0;
}

处理 bytea 类型类似于 VARCHAR 类型。对于类型为 bytea 的数组的定义，会被转换为每个变量的命名结构。类似这样的声明

bytea var[180];

会被转换为

struct bytea_var { int len; char arr[180]; } var;

成员 arr 存储二进制格式的数据。与 VARCHAR 不同，它还可以处理作为数据一部分的 '\0'。数据在 ecpglib 中以十六进制格式转换并发送/接收。

将数组作为主机变量有两种用例。第一个是在 char[] 或 VARCHAR[] 中存储一些文本字符串的方法，如第 34.4.4.1 节中所述。第二个用例是从查询结果中检索多个行，而无需使用游标。如果没有数组，要处理由多个行组成的查询结果，需要使用游标和 FETCH 命令。但是使用数组主机变量，可以一次接收多行。必须定义数组的长度，以能够容纳所有行，否则可能会发生缓冲区溢出。

以下示例扫描 pg_database 系统表，并显示所有可用数据库的 OID 和名称

int
main(void)
{
EXEC SQL BEGIN DECLARE SECTION;
    int dbid[8];
    char dbname[8][16];
    int i;
EXEC SQL END DECLARE SECTION;

    memset(dbname, 0, sizeof(char)* 16 * 8);
    memset(dbid, 0, sizeof(int) * 8);

    EXEC SQL CONNECT TO testdb;
    EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT;

    /* Retrieve multiple rows into arrays at once. */
    EXEC SQL SELECT oid,datname INTO :dbid, :dbname FROM pg_database;

    for (i = 0; i < 8; i++)
        printf("oid=%d, dbname=%s\n", dbid[i], dbname[i]);

    EXEC SQL COMMIT;
    EXEC SQL DISCONNECT ALL;
    return 0;
}

此示例显示以下结果。（确切的值取决于当地情况。）

oid=1, dbname=template1
oid=11510, dbname=template0
oid=11511, dbname=postgres
oid=313780, dbname=testdb
oid=0, dbname=
oid=0, dbname=
oid=0, dbname=

成员名称与查询结果的列名匹配的结构可用于一次检索多个列。该结构使您能够在单个主机变量中处理多个列值。

以下示例从 pg_database 系统表中检索可用数据库的 OID、名称和大小，并使用 pg_database_size() 函数。在此示例中，使用结构变量 dbinfo_t，其成员的名称与 SELECT 结果中的每个列匹配，以检索一个结果行，而无需在 FETCH 语句中放置多个主机变量。

EXEC SQL BEGIN DECLARE SECTION;
    typedef struct
    {
       int oid;
       char datname[65];
       long long int size;
    } dbinfo_t;

    dbinfo_t dbval;
EXEC SQL END DECLARE SECTION;

    memset(&dbval, 0, sizeof(dbinfo_t));

    EXEC SQL DECLARE cur1 CURSOR FOR SELECT oid, datname, pg_database_size(oid) AS size FROM pg_database;
    EXEC SQL OPEN cur1;

    /* when end of result set reached, break out of while loop */
    EXEC SQL WHENEVER NOT FOUND DO BREAK;

    while (1)
    {
        /* Fetch multiple columns into one structure. */
        EXEC SQL FETCH FROM cur1 INTO :dbval;

        /* Print members of the structure. */
        printf("oid=%d, datname=%s, size=%lld\n", dbval.oid, dbval.datname, dbval.size);
    }

    EXEC SQL CLOSE cur1;

此示例显示以下结果。（确切的值取决于当地情况。）

oid=1, datname=template1, size=4324580
oid=11510, datname=template0, size=4243460
oid=11511, datname=postgres, size=4324580
oid=313780, datname=testdb, size=8183012

结构主机变量会 “吸收” 与结构字段一样多的列。其他列可以分配给其他主机变量。例如，上面的程序也可以像这样重构，将 size 变量放在结构之外

EXEC SQL BEGIN DECLARE SECTION;
    typedef struct
    {
       int oid;
       char datname[65];
    } dbinfo_t;

    dbinfo_t dbval;
    long long int size;
EXEC SQL END DECLARE SECTION;

    memset(&dbval, 0, sizeof(dbinfo_t));

    EXEC SQL DECLARE cur1 CURSOR FOR SELECT oid, datname, pg_database_size(oid) AS size FROM pg_database;
    EXEC SQL OPEN cur1;

    /* when end of result set reached, break out of while loop */
    EXEC SQL WHENEVER NOT FOUND DO BREAK;

    while (1)
    {
        /* Fetch multiple columns into one structure. */
        EXEC SQL FETCH FROM cur1 INTO :dbval, :size;

        /* Print members of the structure. */
        printf("oid=%d, datname=%s, size=%lld\n", dbval.oid, dbval.datname, size);
    }

    EXEC SQL CLOSE cur1;

使用 typedef 关键字将新类型映射到已存在的类型。

EXEC SQL BEGIN DECLARE SECTION;
    typedef char mychartype[40];
    typedef long serial_t;
EXEC SQL END DECLARE SECTION;

请注意，您也可以使用

EXEC SQL TYPE serial_t IS long;

此声明不需要是声明部分的一部分；也就是说，您也可以将 typedefs 写成普通的 C 语句。

您声明为 typedef 的任何单词都不能在同一程序中稍后的 EXEC SQL 命令中用作 SQL 关键字。例如，这将不起作用

EXEC SQL BEGIN DECLARE SECTION;
    typedef int start;
EXEC SQL END DECLARE SECTION;
...
EXEC SQL START TRANSACTION;

ECPG 将报告 START TRANSACTION 的语法错误，因为它不再将 START 识别为 SQL 关键字，而只将其识别为 typedef。（如果您有这样的冲突，并且重命名 typedef 似乎不切实际，您可以使用动态 SQL来编写 SQL 命令。）

您可以声明指向最常见类型的指针。但是请注意，您不能在没有自动分配的情况下将指针用作查询的目标变量。有关自动分配的更多信息，请参阅第 34.7 节。

EXEC SQL BEGIN DECLARE SECTION;
    int   *intp;
    char **charp;
EXEC SQL END DECLARE SECTION;