PROC基础知识之指示变量变量

•          指示器变量是与宿主变量相关联的一类SQL变量，它被用来监督和管理与其相关联的宿主变量，每一个宿主变量都可以定义一个指示器变量。指示器变量的具体作用如下：

（1）       向数据库表列输入NULL值

（2）       检查从数据库表列中选取的数据是否是NULL值，或是否发生截断问题

•          指示变量必须被定义为2 个字节的整数类型（short）

•          在SQL 语句中，如果没有指定INDICATOR 关键字，指示变量必须紧跟在与其关联的宿主变量后

•          如果使用DECLARE SECTION 声明宿主变量，则相关指示变量也必须用DECLARE SECTION 进行声明

•         在SQL 语句中指示变量前也需要加入“:”指示符

:host_variable INDICATOR :indicator_variable

等效于

:host_variable:indicator_variable

•         指示变量的值，及其代表的含义如下：

Ø       0 操作成功

Ø       -1 该指示变量对应的宿主变量返回了或插入、更新成了NULL 值

Ø       -2 从数据库存放数据到对应的宿主变量时，数据超长，并且不能推断出截断了多少字节的长度

Ø       >0 在FETHC 或SELECT 语句时，因数据超长而被截断存放在了对应的宿主变量中，指示变量存放对应列的长度

•         如果不用指示变量在SELECT或FETCH语句中将一个NULL值赋给宿主变量时，Oracle会报1405 错误。为了避免这种情况，可以采用两种解决方法：

Ø       使用指示变量

Ø       调整Pro*C/C++预编译程序proc 的命令行参数，设定MODE=ORACLE，UNSAFE_NULL=YES

 

指示器变量的引用:

  在SQL语句中，指示器变量名字前应加冒号，而且必须在其相关联的宿主变量之后。在C语言中，指示器变量如同C变量一样独立使用，不须前缀冒号，也不须跟在相关宿主变量之后。例如：

EXEC SQL SELECT EMPN()

               INTO::emp_number：ind_num

               FROM EMP

               WHERE ENAME = :emp_name；

If （ind_num  =  -1）

{

        Printf（“employlee number is NULL！”）；

}

为了增进可读性，可以再宿主变量及其指示器变量之间加INDICATOR关键词。如：

EXEC SQL SELECT EMPNO

        INTO:emp_number INDICATOR:ind_num

        FROM EMP

        WHERE ENAME = :emp_name；

 

指示器变量的应用举例：

例1：向数据库表列中插入NULL值

Printf（“enter department number and name”）；

Scanf（“%d%s”， &dept_number， dept_name）；

If （dept_number = 0）

{

        Ind_num = -1；

}

else

{

        Ind_num = 0;

}

EXEC SQL INSERT INTO DEPT(DEPTNO,DNAME)VALUES(:dept_number:ind_num, :dept_name)

其中ind_num是dept_number的指示器变量，当输入的dept_number的值是0的时候，则向DEPT表的DEPTNO列插入NULL值

 

例2：检查从数据库表列中检索的值是否为NULL

EXEC SQL BEGIN DECLARE SECTION;

int          emp_number;

float              salary, commission;

short              ind_comm; /* 指示变量 */

EXEC SQL END DECLARE SECTION;

 

EXEC SQL SELECT SAL, COMM

INTO :salary, :commission:ind_comm

FROM EMP

WHERE EMPNO = :emp_number;

if( -1 == ind_comm ) /* commission变量是NULL */

        pay = salary;

else

        pay = salary + commission;