33.4. 使用宿主变量

在Section 33.3 里你看到了如何从嵌入的SQL程序里执行SQL语句。那些语句有些只使用了固定的数值，并没有提供一个插入用户提供的数值到语句中的方法，也没有提供让程序访问查询返回的数值的方法。这种类型的语句在实际应用中并不是很有用。本节详细解释如何在你的C程序和嵌入的SQL语句之间使用一种被称作宿主变量的机制传递数据。在嵌入SQL程序中，我们将SQL语句认为是宿主语言_C程序编码的客人。因此C程序变量称为宿主变量_。

在PostgreSQL后端和ECPG应用程序之间改变值的另一种方式是使用SQL描述符，参见Section 33.7中的描述。

33.4.1. 概述

在C程序和SQL语句之间传递数据在嵌入的 SQL 里是特别简单的。我们不用把数据粘贴到语句中，这样必然会有各种复杂事情需要处理，比如正确地给数值加引号等等，我们只需要在SQL语句里写上C变量的名字，前缀一个冒号即可。比如：

EXEC SQL INSERT INTO sometable VALUES (:v1, 'foo', :v2);

这个语句引用了两个变量,一个叫v1，另一个叫v2，并且也使用一个普通的SQL字串文本，这样表明你并不局限于只使用某一种数据或者其他。

这种在SQL语句里插入C变量的方式在SQL语句里任何需要表达式的地方都可用。

33.4.2. 声明段

要从程序向数据库传递数据，比如，查询中的参数，或者从数据库里向程序传回的数据，想包含这类数据的 C变量必须在一个特殊的标记段里面声明，这样嵌入的SQL预处理器就会明白要做什么。

这个段以下面的代码开头：

EXEC SQL BEGIN DECLARE SECTION;

以下面的代码结束:

EXEC SQL END DECLARE SECTION;

在这些行之间，有普通的C变量声明，比如：

int   x = 4;
char  foo[16], bar[16];

正如你所看到的，你可以随意指定一个初始值给变量。变量的范围是在程序中通过其声明部分的位置确定。你也可以用下面的语法，隐式地创建一个声明段声明变量：

EXEC SQL int i = 4;

在程序里你可以有任意多个声明段。

这些声明也同时以普通C变量的形式回显到输出文件中，因此，我们不必再声明他们。那些不准备在SQL命令里使用的变量通常可以在这些特殊的段外面声明。

结构或者联合的定义也必须在DECLARE段中列出。否则，预处理器就无法处理这些类型，因为它不知道定义。

33.4.3. 检索查询结果

现在你应该能把你的程序生成的数据传递到SQL命令里面去了。但是你如何检索一个查询的结果呢？为了这个目的，嵌入的SQL提供了常用命令SELECT和 FETCH的特殊变体。这些命令有了特殊的INTO子句，声明检索出来的数值存储在哪个宿主变量里。 SELECT用于返回单行的查询，同时FETCH 用于使用游标返回多行的查询。

下面是一个例子：

/*
 * 假设表是这个:
 * CREATE TABLE test1 (a int, b varchar(50));
 */

EXEC SQL BEGIN DECLARE SECTION;
int v1;
VARCHAR v2;
EXEC SQL END DECLARE SECTION;

 ...

EXEC SQL SELECT a, b INTO :v1, :v2 FROM test;

所以INTO子句出现在选择列表和FROM子句之间。选择列表和INTO后面的列表的元素（也叫目标列表）个数必须相同。

下面是使用FETCH命令的例子：

EXEC SQL BEGIN DECLARE SECTION;
int v1;
VARCHAR v2;
EXEC SQL END DECLARE SECTION;

 ...

EXEC SQL DECLARE foo CURSOR FOR SELECT a, b FROM test;

 ...

do
{
    ...
    EXEC SQL FETCH NEXT FROM foo INTO :v1, :v2;
    ...
} while (...);

这里的INTO子句出现在所有正常的子句后面。

33.4.4. 类型映射

当ECPG应用程序改变PostgreSQL服务器和C应用程序之间的值的时候，比如检索来自服务器的查询结果或者执行带有输入参数的SQL语句，在PostgreSQL数据类型和宿主语言变量类型（具体地C语言数据类型）之间需要改变值。ECPG的一个主要点之一是在大多数情况下自动的关注这个。

在这方面，有两种数据类型：一些简单的 PostgreSQL数据类型，如integer和text，可以直接通过应用程序读取和写入。其他PostgreSQL数据类型，如 timestamp和numeric只能通过特殊库函数进行访问；参阅Section 33.4.4.2。

Table 33-1显示了哪个PostgreSQL 数据类型对应哪个C数据类型。当你希望发送或接收一个给定PostgreSQL数据类型的值时，你应该在声明部分声明一个对应C数据类型的C变量。

Table 33-1. PostgreSQL数据类型和C变量类型之间的映射

PostgreSQL数据类型	宿主变量类型
`smallint`	`short`
`integer`	`int`
`bigint`	`long long int`
`decimal`	`decimal`[a]
`numeric`	`numeric`[a]
`real`	`float`
`double precision`	`double`
`smallserial`	`short`
`serial`	`int`
`bigserial`	`long long int`
`oid`	`unsigned int`
character(``_n_), varchar(``_n_), `text`	char[``_n_+1], VARCHAR[``_n_+1][b]
`name`	`char[NAMEDATALEN]`
`timestamp`	`timestamp`[a]
`interval`	`interval`[a]
`date`	`date`[a]
`boolean`	`bool`[c]
Notes: a. 这种类型可以通过特殊库函数访问；参阅Section 33.4.4.2。 b. 在`ecpglib.h`中声明 c. 如果不是本地的，在`ecpglib.h`中声明

33.4.4.1. 处理字符串

为了处理SQL字符串数据类型，比如varchar和text，有两种可能方式声明宿主变量。

一种方式是使用char[]，char数组是在C中处理字符数据最常见方式。

EXEC SQL BEGIN DECLARE SECTION;
    char str[50];
EXEC SQL END DECLARE SECTION;

请注意，你必须关注自身长度。如果你使用这个宿主变量作为查询返回一个具有多于49个字符的字符串的目标变量，那么发生缓冲区溢出。

另一种方法是使用VARCHAR类型，这是一个由ECPG提供的特殊类型。VARCHAR类型的数组定义被转换为每个变量的命名结构。声明如：

VARCHAR var[180];

转换成：

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

arr有一个终止零字节的字符串。因此，为了在VARCHAR宿主变量中存储字符串，宿主变量必须声明为包含零字节终结符的长度。 len持有存储在arr中而没有终止零字节的字符串长度。当一个宿主变量作为一个查询输入时，如果strlen(arr) 和len是不同的，那么使用稍短的。

两个或以上VARCHAR宿主变量不能在单行语句中被声明。下面的代码将混淆ecpg预处理程序：

VARCHAR v1[128], v2[128];   /* WRONG */

两个变量应该像下面这样在独立语句中进行定义：

VARCHAR v1[128];
VARCHAR v2[128];

VARCHAR可以使用大写或小写，但是在不混淆的情况下。

char和VARCHAR宿主变量可以持有其它SQL类型的值，这将被存储在它们的字符串形式中。

33.4.4.2. 访问特定数据类型

ECPG含有一些特定类型帮助你与来自PostgreSQL服务器的一些特殊数据类型进行轻松互动。特别是，它已经实现支持numeric, decimal, date, timestamp和interval类型。这些数据类型不能有效地映射到原始主机变量类型（例如 int, long long int或者char[]），因为他们有一个复杂的内部结构。应用程序通过声明特殊类型的主机变量处理这些类型，并且在pgtypes库中使用函数访问他们。该pgtypes库包含处理这些类型的基本函数的详细描述参阅Section 33.6，这样你就不需要发送一个查询到SQL服务器，仅仅为了添加间隔时间戳例子。

以下小节描述了这些特殊数据类型。为了获得关于pgtypes库函数的更多细节，参阅Section 33.6。

33.4.4.2.1. timestamp, date

这是在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

此外，日期类型可以用同样的方式处理。程序必须包括pgtypes_date.h，作为日期类型声明一个宿主变量并且使用 PGTYPESdate_to_asc()函数转换日期值为文本形式。关于pgtypes库函数的更多详情，请参阅Section 33.6。

33.4.4.2.2. interval

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;

    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;
}

33.4.4.2.3. numeric, decimal

numeric和decimal类型的处理类似于 interval类型：它需要定义一个指针，在堆上分配一些内存空间，并且使用pgtypes库函数访问变量。关于pgtypes库函数的更多细节，参阅Section 33.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;

    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));

/*转换十进制到数值型以显示十进制值*/
    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;
}

33.4.4.3. 使用非初级类型的宿主变量

作为一个宿主变量你也可以使用数组，typedefs，结构和指针。

33.4.4.3.1. Arrays

有两个作为宿主变量的数组用例。最先的一种方式是在char[] 或者VARCHAR[]中存储一些文本字符串，正如Section 33.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 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=

33.4.4.3.2. 结构

一个成员名称匹配查询结果列名称的结构，可用于一次检索多个列。该结构可以在单一的宿主变量中处理多个列的值。

下面的示例检索OID，名称，和来自pg_database 系统表可用数据库的大小，并且使用 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;

/*当结果集到达末尾时，打破while循环*/
    EXEC SQL WHENEVER NOT FOUND DO BREAK;

    while (1)
    {

/*抓取多列到一个结构中*/
        EXEC SQL FETCH FROM cur1 INTO :dbval;

/*打印结构成员*/
        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;

    /*当结果集到达末尾时，打破while循环*/
    EXEC SQL WHENEVER NOT FOUND DO BREAK;

    while (1)
    {

/*抓取多列到一个结构中*/
        EXEC SQL FETCH FROM cur1 INTO :dbval, :size;

/*打印结构成员*/
        printf("oid=%d, datname=%s, size=%lld\n", dbval.oid, dbval.datname, size);
    }

    EXEC SQL CLOSE cur1;

33.4.4.3.3. Typedefs

使用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;

这种声明并不需要声明部分。

33.4.4.3.4. 指针

你可以声明最常见类型的指针。然而注意你不能作为没有自动分配的查询目标变量而使用指针。参阅Section 33.7获取更多自动配置的信息。

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

33.4.5. 处理非初级的SQL数据类型

本节包含了如何处理nonscalar和ECPG应用程序中用户自定义的SQL级别数据类型的相关信息。请注意这不同于非初级类型宿主变量的处理，在前面的章节中有描述。

33.4.5.1. 数组

在ECPG中不直接支持SQL级别数组。不可能简单的映射SQL数组到C数组宿主变量。这将产生未定义操作。然而，存在一些解决方法。

如果查询分别访问数组元素，那么这可以避免在ECPG中使用数组。然后，应该使用可以映射到元素类型的宿主变量。比如，如果列类型是integer数组，那么使用int类型宿主变量。如果元素类型是varchar或者text，则可以使用char[]或者VARCHAR[]类型宿主变量。

下面是一个例子。假设下列表:

CREATE TABLE t3 (
    ii integer[]
);

testdb=> SELECT * FROM t3;
     ii
-------------
 {1,2,3,4,5}
(1 row)

下面示例程序检索了数组的第四个元素，并且将它存储在int类型的宿主变量中：

EXEC SQL BEGIN DECLARE SECTION;
int ii;
EXEC SQL END DECLARE SECTION;

EXEC SQL DECLARE cur1 CURSOR FOR SELECT ii[4] FROM t3;
EXEC SQL OPEN cur1;

EXEC SQL WHENEVER NOT FOUND DO BREAK;

while (1)
{
    EXEC SQL FETCH FROM cur1 INTO :ii ;
    printf("ii=%d\n", ii);
}

EXEC SQL CLOSE cur1;

该例子显示了下面结果：

ii=4

为了映射多个数组元素到数组列的数组类型宿主变量每个元素的多个元组，并且宿主变量数组的每个元素必须分别被管理，比如：

EXEC SQL BEGIN DECLARE SECTION;
int ii_a[8];
EXEC SQL END DECLARE SECTION;

EXEC SQL DECLARE cur1 CURSOR FOR SELECT ii[1], ii[2], ii[3], ii[4] FROM t3;
EXEC SQL OPEN cur1;

EXEC SQL WHENEVER NOT FOUND DO BREAK;

while (1)
{
    EXEC SQL FETCH FROM cur1 INTO :ii_a[0], :ii_a[1], :ii_a[2], :ii_a[3];
    ...
}

请再次注意

EXEC SQL BEGIN DECLARE SECTION;
int ii_a[8];
EXEC SQL END DECLARE SECTION;

EXEC SQL DECLARE cur1 CURSOR FOR SELECT ii FROM t3;
EXEC SQL OPEN cur1;

EXEC SQL WHENEVER NOT FOUND DO BREAK;

while (1)
{
    /* WRONG */
    EXEC SQL FETCH FROM cur1 INTO :ii_a;
    ...
}

不会在这种情况下正确工作，因为你不能映射一个数组类型列直接到数组宿主变量。

另外一种方法是在char[] 或者VARCHAR[]类型宿主变量的外部字符串形式中存储数组。更多关于该形式的详细信息，请参阅Section 8.15.2。注意这意味着在主程序（没有对分析文本表示的进一步处理）中数组自然不能作为数组被访问。

33.4.5.2. 复合类型

在ECPG中不直接支持复合类型，但是简单解决方法是可能的。可用的方法与上面数组描述的那个是类似的：要么分别访问每个属性，要么使用外部字符串表示形式。

下面列子中，假设下面类型和表：

CREATE TYPE comp_t AS (intval integer, textval varchar(32));
CREATE TABLE t4 (compval comp_t);
INSERT INTO t4 VALUES ( (256, 'PostgreSQL') );

最明显的解决方法是分别访问每个属性。下面程序通过分别选择类型comp_t 的每个属性的示例表中检索数据：

EXEC SQL BEGIN DECLARE SECTION;
int intval;
varchar textval[33];
EXEC SQL END DECLARE SECTION;

/*将复合类型列的每个元素放在SELECT列表中*/

EXEC SQL DECLARE cur1 CURSOR FOR SELECT (compval).intval, (compval).textval FROM t4;
EXEC SQL OPEN cur1;

EXEC SQL WHENEVER NOT FOUND DO BREAK;

while (1)
{

/*抓取复合类型列的每个元素给宿主变量*/
    EXEC SQL FETCH FROM cur1 INTO :intval, :textval;

    printf("intval=%d, textval=%s\n", intval, textval.arr);
}

EXEC SQL CLOSE cur1;

为了加强这个例子，在FETCH命令中存储值的宿主变量可以聚集在一个结构中。关于结构形式中宿主变量的更多细节，参阅Section 33.4.4.3.2。为了切换到结构，例子可以做如下修改。两个宿主变量intval和textval，是comp_t结构成员，并且在FETCH命令上指定结构。

EXEC SQL BEGIN DECLARE SECTION;
typedef struct
{
    int intval;
    varchar textval[33];
} comp_t;

comp_t compval;
EXEC SQL END DECLARE SECTION;

/*将复合类型列的每个元素放在SELECT列表中*/

EXEC SQL DECLARE cur1 CURSOR FOR SELECT (compval).intval, (compval).textval FROM t4;
EXEC SQL OPEN cur1;

EXEC SQL WHENEVER NOT FOUND DO BREAK;

while (1)
{

/*将SELECT列表中所有值放到结构中*/

    EXEC SQL FETCH FROM cur1 INTO :compval;

    printf("intval=%d, textval=%s\n", compval.intval, compval.textval.arr);
}

EXEC SQL CLOSE cur1;

虽然结构用于FETCH命令，逐一指定SELECT 子句中的属性名，这可以通过使用 *请求复合类型值的所有属性获得提高。

...
EXEC SQL DECLARE cur1 CURSOR FOR SELECT (compval).* FROM t4;
EXEC SQL OPEN cur1;

EXEC SQL WHENEVER NOT FOUND DO BREAK;

while (1)
{

/*将SELECT列表中的所有值放到结构中*/
    EXEC SQL FETCH FROM cur1 INTO :compval;

    printf("intval=%d, textval=%s\n", compval.intval, compval.textval.arr);
}
...

这种方式，可以无缝的将复合类型映射到结构中，尽管ECPG并不了解该复合类型。

最后，在类型char[]或者VARCHAR[]宿主变量中的外部字符串表示形式中存储复合类型是可能的。但是那种方式，不容易从主程序中访问值的字段。

33.4.5.3. 用户自定义基本类型

ECPG不直接支持新用户自定义基础类型。你可以使用外部字符串表示形式和类型char[]或者VARCHAR[]的宿主变量，并且该方法对于许多类型的确是合适的并且充分的。

这是一个使用Section 35.11中复合数据类型的例子。该类型的外部字符串表示形式是(%lf,%lf)，定义在Section 35.11中的complex_in() 和complex_out()函数中。下面例子将复合类型值(1,1) 和(3,3)插入到列a和b中，并且之后从表中选择它们。

EXEC SQL BEGIN DECLARE SECTION;
    varchar a[64];
    varchar b[64];
EXEC SQL END DECLARE SECTION;

    EXEC SQL INSERT INTO test_complex VALUES ('(1,1)', '(3,3)');

    EXEC SQL DECLARE cur1 CURSOR FOR SELECT a, b FROM test_complex;
    EXEC SQL OPEN cur1;

    EXEC SQL WHENEVER NOT FOUND DO BREAK;

    while (1)
    {
        EXEC SQL FETCH FROM cur1 INTO :a, :b;
        printf("a=%s, b=%s\n", a.arr, b.arr);
    }

    EXEC SQL CLOSE cur1;

这个例子显示了如下结果:

a=(1,1), b=(3,3)

另一种方法是避免ECPG中用户自定义类型的直接使用，并且创建一个函数或者计算在用户自定义类型和ECPG处理的原始类型之间的转换。注意，然而那个类型计算，特别是隐式的那个，应该小心引入类型系统中。

比如，

CREATE FUNCTION create_complex(r double, i double) RETURNS complex
LANGUAGE SQL
IMMUTABLE
AS $$ SELECT $1 * complex '(1,0')' + $2 * complex '(0,1)' $$;

这个定义之后，下面

EXEC SQL BEGIN DECLARE SECTION;
double a, b, c, d;
EXEC SQL END DECLARE SECTION;

a = 1;
b = 2;
c = 3;
d = 4;

EXEC SQL INSERT INTO test_complex VALUES (create_complex(:a, :b), create_complex(:c, :d));

具有相同效果正如

EXEC SQL INSERT INTO test_complex VALUES ('(1,2)', '(3,4)');

33.4.6. 指示器

上面的例子不能处理空值。实际上，如果从数据库中抓到一条空值，那么上面的检索例子会抛出一个错误。要能够向数据库中传递空值，或者从数据库中检索空值，你需要给每个包含数据的宿主变量后面附加一个额外的宿主变量。这第二个宿主变量叫指示器，里面包含一个标志，告诉我们数据是否为空，如果为空，那么真正的宿主变量的数值就可以忽略。下面是一个能正确检索空值的例子:

EXEC SQL BEGIN DECLARE SECTION;
VARCHAR val;
int val_ind;
EXEC SQL END DECLARE SECTION:

 ...

EXEC SQL SELECT b INTO :val :val_ind FROM test1;

如果数值不是空，那么指示器变量val_ind将是零，如果值是空，那么它将是负数。

指示器还有另外的一个用途，如果指示器值是正数，则意味着值不空，但是在数值存储到宿主变量里的时候被截断了。

如果参数-r no_indicator被传递给预处理器ecpg，那么它在"no-indicator"模式下工作。在非指示器模式下，如果没有声明可用指示器，那么为了将字符串类型作为空字符串以及整数类型作为类型的最小可能值（比如，int最小为INT_MIN），则使用空值（在输入和输出上）。